用途:当用户明确需要持久的 plan.md、progress.md、result.md 交付制品,或工作真正需要跨仓库、跨工作流协调时使用。常规小改动不应因“可能有用”而创建这些文件。
主要能力:按实际复杂度匹配流程;先用 references/orchestration-model.md 判断执行形态,默认顺序执行,仅当工作流通过独立性检验时才并行。三个制品由各自契约文件规定必需章节与状态语义:plan.md 对应 references/planning-contract.md,progress.md(别名 task.md)对应 references/reporting-contract.md,result.md 对应 references/handoff-contract.md。
使用方式(必要命令保持原样): scripts/init_docs.sh <target_dir> python3 scripts/validate_plan.py <plan.md> python3 scripts/validate_progress.py <progress.md> python3 scripts/validate_result.py <result.md> scripts/smoke_test.sh 脚本从技能目录运行。init_docs.sh 只复制缺失模板,不覆盖已有制品。执行中在状态、阻塞、范围或里程碑变化时更新 progress.md,done 状态须有可检查的工具证据支撑;按依赖顺序集成并写下 result.md。
限制与边界:同一仓库或文件范围同时只有一个写入者,重叠写入须串行化;计划不授权超出用户请求的工作,范围外机会只记录不实现;结构性校验通过不代表交付目标成功;progress.md 与 task.md 是别名,不可作为两个状态源并存,也不得互相分歧;不要为凑完整而创造额外角色、工作流或产出;证据变化影响范围、依赖或验收标准时先更新制品再继续。制品应保存在目标工作区而非技能目录。适用 Bash 与 Python 3。收费、价格与平台等资料暂未提供。