writing-plans 是面向仓库项目计划的写作技能,用于在 docs/plans/ 下创建结构化计划文档,跟踪功能差距、实施阶段与里程碑。
用途:规划功能集或功能对齐工作并进行差距分析;创建带里程碑的文档或内容计划;组织含分阶段任务拆解的实施路线图;用 emoji 进度标记跨功能跟踪状态;编写与实施阶段绑定的测试计划。不适合的场景:快速缺陷修复用 GitHub issue;单功能实施用 PR 描述或 issue;架构决策记录用 ADR(docs/adr/NNNN-title.md);会议记录或状态同步用 GitHub discussions 或 wiki;技能文档用 designing-workflow-skills 技能。
主要能力与结构约定:标题后第一段内容为 > 引用块,说明计划目标。计划通常 500–1200 行,需带锚点的编号目录,顶层用 ## 1.、子节用 ### 1.1 并链接。功能差距表用 ✅(已实现)、🔧(部分)、❌(缺失),里程碑用 - [ ] / - [x],且在首个使用状态标记的表格前加 Legend 说明。每个阶段格式为 ### Phase N: Title (Priority: High|Medium|Low),紧随加粗 Goal:,任务表用 N.M 编号,每阶段最后一项任务为测试。计划是活文档,已完成阶段保留;范围变更在末尾新增 Amendments 段而非重写。
计划类型:功能对齐/差距分析计划(差距表、实施阶段、测试计划、可选基准与迁移指南);文档/内容计划(结构树、分节拆解、里程碑、可选写作风格指南)。不确定时先用功能对齐模板,再按需删减。文件位于 docs/plans/<name>.md,命名用短横线小写、具描述性,如 cqlengine-feature-parity.md、documentation-plan.md。
用法:写作前按 setup-environment.md 配置环境,并在提交前安装钩子:uv sync --all-groups 与 uv run pre-commit install。创建与计划阶段相关的 PR 时,在 PR 正文中添加 Plan: docs/plans/<plan-name>.md 与 Phase: N,Plan Phase Continuation 工作流会在合并时把下一阶段委派给 Copilot,缺少这两行则工作流跳过,支持字母阶段如 Phase: C。
限制:文档未提供收费、价格、平台或效果等信息;相关模板、创建流程与自动化细节需参见其引用文件与仓库贡献说明。