Content
68%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-organized, mostly lean body with executable quick-start code and verified one-level-deep references for core concepts and buy/sell points. Weaknesses center on the implicit user workflow (no sequenced steps or validation checkpoints) and signal functions that are listed but never demonstrated.
Suggestions
Add a short numbered workflow section (prepare bars → construct CZSC → inspect bi_list/中枢 → apply a signal function), including a validation checkpoint such as confirming a minimum bar count before interpreting signals.
Show one executable example of calling a signal function (e.g. cxt_first_buy_V221126 on a CZSC/Cat object) and reading its 1/-1/0 output, since the functions are currently only named.
Add a reference file for the full signal-function catalog and multi-timeframe analysis so the remaining ~28 functions and 多周期分析 have a natural home in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and table-driven, and the niche Chan-theory terminology justifies its brief definitions, but time-sensitive details — the 'v0.9.68+' version pin and the '43 个缠论信号函数' count — will go stale and are not in a deprecated/old-patterns section. | 4 / 5 |
Actionability | The quick start is copy-paste ready (complete RawBar construction, CZSC usage, pip install) and the data-format table is concrete, but the 15 listed signal functions are never shown being called, leaving a minor execution gap. | 4 / 5 |
Workflow Clarity | The stated pipeline '原始K线 → 去包含处理 → 分型识别 → 笔检测 → 中枢构建 → 买卖点判定' describes the library's internals, not the user's workflow; the actual sequence (install → prepare bars → construct CZSC → access results → apply signals) is only implied by section order with no validation checkpoints such as verifying a non-empty bi_list or minimum bar count. | 3 / 5 |
Progressive Disclosure | All six referenced files (references/核心概念/分型.md, 笔.md, 中枢.md and references/买卖点/一买一卖.md, 二买二卖.md, 三买三卖.md) exist one level deep and are clearly signaled via the '详细文档' table columns; minor gaps include no reference covering the remaining ~28 signal functions or 多周期分析. | 4 / 5 |
Total | 15 / 20 Passed |