SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-15 19:52

技能介绍

用途:在拿到多步任务的规格或需求后、开始写代码前,编写完整的实施计划。计划假设执行工程师熟悉开发但不了解本项目工具链与问题域,因此需要写清楚每个任务要改哪些文件、代码、测试与文档。

主要能力:以“小步任务”粒度组织计划,每步约 2-5 分钟,典型顺序为编写失败测试、运行确认失败、写最小实现、运行确认通过、提交。计划文档要求包含固定头部(目标、架构、技术栈),任务中给出精确文件路径(创建/修改/测试)、完整代码、带预期输出的确切命令。规范上遵循 DRY、YAGNI、TDD 和频繁提交。

使用方式:开始前声明“I'm using the writing-plans skill to create the implementation plan.”;建议在由 brainstorming 技能创建的专用 worktree 中运行;计划保存到 docs/plans/YYYY-MM-DD-<feature-name>.md。生成完整计划后,只向对话输出摘要表格,并以“Full plan saved to ...”结束,不把完整计划打印到对话中。随后提供两种执行方式选择:本会话内的 Subagent-Driven(配合 software-forge:subagent-driven-development)或另开会话的 Parallel Session(配合 software-forge:executing-plans)。

经验查询:计划定稿前要求从 neo4j-agent-memory 查询过往经验,先提取 3-5 个关键技术概念,再对每个概念执行 memory_search,并用给定的 Cypher 查询检索跨项目原则,把矛盾或有帮助的结论转为任务约束或警告,并在计划头部的 Experience Applied: 中记录;若 neo4j-agent-memory 不可用则跳过,不影响计划生成。

限制:资料未提供该技能的收费、价格、支持平台或具体效果数据;上述经验查询依赖外部 neo4j-agent-memory,缺失时相关步骤会被跳过。