Agent skill
plan-md-writer
基于当天的 Intake 文件生成可执行计划 `plan_<topic>.md`,并落盘到 `<MM_DD>/codex/plan/`;计划包含 Tasks+DoD+Dependencies、可选 Gates、Deliverables(当天目录路径)与 Rollback。适用于“基于intake写计划/生成plan_<topic>.md/补DoD和门禁”等请求。
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/plan-md-writer
SKILL.md
Plan MD Writer(当天落盘版)
目录协议(强制)
- 输入:
<MM_DD>/codex/intake/intake_<topic>.md - 输出:
<MM_DD>/codex/plan/plan_<topic>.md - Deliverables 必须指向当天目录下的具体文件路径
- 若目标文件已存在:先给差异摘要,等待用户确认后再覆盖/更新
执行前先给 Plan(强制)
在写文件前,先输出 3 行以内的计划,让用户确认:
- 读取 intake 并抽取 Tasks/Goal/Scope
- 生成 plan 模板并补齐 DoD/Gates/Deliverables/Rollback
- 写入
plan_<topic>.md
输出模板(必须块)
# Plan: <topic>
## Goal
...
## Scope
- In:
- Out:
## Tasks
- [ ] T1 ...
- DoD:
- Dependencies:
- [ ] T2 ...
- DoD:
- Dependencies:
## Gates (optional)
- Gate1:
- Gate2:
## Deliverables
- <MM_DD>/codex/report/report_<topic>.md
- <MM_DD>/codex/artifact/manifest_<topic>.json
- (if needed) <MM_DD>/codex/daily/daily.md
## Rollback
- ...
## Execution Log
- (leave blank)
操作步骤
- 要求用户给出(或确认)
<MM_DD>与<topic> - 读取
intake_<topic>.md,抽取并规范化:- Goal:一句话目标
- Scope:In/Out(若 intake 没写,补 “TBD” 并列出假设)
- Tasks:改写为动词开头、可执行;必要时拆分为 2-5 条
- 为每个 Task 补 DoD:
- 以可验证为准(文件/命令/日志/指标)
- Gates:
- 默认留空;若用户同意,可从下列门禁中选择加入(按任务相关性选择最少集合)
python main.py --config configs/demo/00_smoke/dummy_dg.yamlpython -m scripts.validate_configspython -m pytest test/
- 默认留空;若用户同意,可从下列门禁中选择加入(按任务相关性选择最少集合)
- Deliverables:
- 固定至少包含 manifest 路径;report 若本轮不产出则标注 “TBD/由后续生成”
- Rollback:
- 写清“失败如何回退到安全状态”(例如撤销变更/恢复文件/仅保留草案)
- 创建目录(如不存在):
<MM_DD>/codex/plan/ - 写入
plan_<topic>.md
完成判定(DoD)
plan_<topic>.md已创建在约定路径- 每个 Task 都有 DoD;Deliverables 全部是当天目录路径
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?