用途:为软件项目创建同步的实施计划与进度跟踪文件,二者放在项目 docs/ 目录下,前缀必须一致,每个进度项都能追溯到计划阶段,每个计划阶段都有进度覆盖。
主要能力:支持两种模式——Greenfield(从零规划)与 Gap(对比现有实现与目标范围,规划缺失工作)。计划包含目标、范围边界、基线、里程碑、交付物、依赖、风险、验收标准、延后/范围外工作及下一步。进度文件使用稳定数字 ID(1.0、1.1、2.0)与 ASCII 复选框,更新时保留已完成 [x] 项,最后一项复选框为归档步骤。
使用方式:先读取 README、规划文档、docs/*-progress.txt 及相关源码结构,收集上下文,未知事实明确标注而非编造。文件命名用唯一工作项 ID 或短 kebab-case 特征名,如 docs/W-000025-IMPLEMENTATION_PLAN.md 与 docs/W-000025-progress.txt。可用 scripts/init_progress_txt.sh <plan-file> [progress-file] 初始化进度文件;完成后用 scripts/archive_plan.sh <plan-file> <progress-file> 或 git mv 将两文件移入 docs/archive/。输出格式参考 references/output-contract.md,未指定技术栈时可参考 STACK_DEFAULTS.md。
适用场景:独立创建或更新计划/进度,无需已跟踪工作项来源。若用户想要 GitHub Issues 用户故事待办,应改用 arc-creating-user-stories;若需规划已有跟踪工作项的实施,应改用 arc-planning-work。
限制:资料未提供具体收费、平台支持范围或效果保证;脚本与参考文件的实际内容暂未提供。