Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with a clear, validated multi-step workflow and rich operational guidance, but it suffers from repeated explanations of the same strategy and a broken external reference that undermines its progressive-disclosure structure.
Suggestions
Create the referenced docs/post-deploy-verification.md (or remove/fix the citation) so the two inline references resolve to a real file.
Consolidate the get-link/work_list aweme_id strategy and the AI-declaration flow into single authoritative sections instead of restating them in 使用方式, aweme_id 捕获, and the ai_declaration_confirm pitfall.
Move dated incident notes (2026-07-17) into a 'Postmortems / old patterns' section so time-sensitive detail does not dilute the main instructions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly operational (exit codes, selectors, API paths Claude would not already know), but the get-link/work_list strategy and the AI-declaration flow are each restated across multiple sections, and dated inline incident notes (2026-07-17) are not isolated in a deprecated section, so it could be tightened. | 2 / 3 |
Actionability | It provides copy-paste-ready commands (douyin-publish run/upload/fill/publish/get-link with flags), exact creator-center URLs, concrete localStorage keys, and an exit-code table mapping each code to a caller action. | 3 / 3 |
Workflow Clarity | The upload → fill → publish → get-link sequence is explicit, with validation checkpoints (draft-popup cleanup, aweme_id capture, login-expiry detection) and feedback loops (exit 2 → login-manager re-login, exit 3 → manual verification). | 3 / 3 |
Progressive Disclosure | Sections are organized (使用方式, 必做约束, Exit codes, Pitfalls, Notes), but the only external reference, docs/post-deploy-verification.md, is cited twice and does not exist in the bundle, and detailed pitfall/strategy content that could live in separate files is kept inline. | 2 / 3 |
Total | 10 / 12 Passed |