SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-15 21:49

技能介绍

用途:在拿到规格或需求、尚未触碰代码前,为多步骤任务编写实施计划;当工作跨越多个计划(阶段、倡议、多计划交付的 PRD)时,先写并持续维护已提交的路线图 docs/roadmap.md。

主要能力:计划假设执行工程师对本代码库零上下文,需写明每个任务要改哪些文件、函数签名、测试用例、需查阅的文档及验证方式,拆成 2–5 分钟的小步骤(写失败测试→看它失败→最小实现→看它通过→提交)。计划必含章节:Goal、Impact Analysis、Approach、Step-by-step TDD tasks、Risks、Rollback、Out of scope。影响分析须给出改动触及的每个符号的上下调用链。对现有代码的事实陈述须附实际读过的 file:line,无法核实的要明说。路线图含状态表、策略、各阶段验收标准与对应 PRD 用户故事编号、停止规则、用户同意记录(引用原话与日期)。

使用方式:在专用 worktree 中运行,开始时声明“I'm using the writing-plans skill to create the implementation plan.”。计划保存到 docs/plans/<TICKET>-<slug>.md,无工单时用 docs/plans/YYYY-MM-DD-<slug>.md;计划永不提交,需将 docs/plans/ 加入 .git/info/exclude。路线图保存到 docs/roadmap.md 并提交,状态变更随该阶段 PR 更新。首个阶段计划前须获得用户对策略的明确同意,否则停下询问。计划完成后提供两种执行方式:本会话子代理驱动,或另开会话用 executing-plans 批量执行。

限制:默认用 Medium thinking,仅在架构全新子系统、复杂分布式状态机或零停机数据库迁移时升到 HIGH。计划不写完整函数体,仅在文本本身即决策处(正则、配置、迁移、数据格式)写字面代码;引用的行范围须与替换文本一致;每个 gate 必须能失败且已亲眼见其失败。资料未提供具体收费、平台支持范围等信息。