SuperAPI AI 工具集

planning

通用与其它

查看项目

更新于 10-16 08:11

技能介绍

用途:在需要规划可扩展、安全、可维护的技术方案时使用,本技能只负责产出计划,不实现代码。适用场景包括新功能实施规划、系统架构设计、技术方案评估、实施路线图创建、复杂需求拆解以及技术权衡评估。

主要能力与流程:遵循 YAGNI、KISS、DRY 原则,工作流为初始分析(阅读代码库文档、理解上下文)、研究阶段(派出研究人员调研方案)、综合(分析报告、确定最优解)、设计阶段(创建架构与实施设计)、计划文档编写、评审与完善。各阶段按需加载参考资料:research-phase.md、codebase-understanding.md、solution-design.md、plan-organization.md、output-standards.md;若已获得研究员报告可跳过研究阶段,已获得 scout 报告可跳过代码库理解。

输出与结构:以计划文件路径与摘要作为响应,计划需自包含并包含必要上下文,必要时给出代码片段或伪代码,适当提供多方案及权衡。计划目录结构为 plans/{date}-plan-name/ 下含 research/、reports/、scout/ 子目录以及 plan.md、phase-XX-phase-name-here.md。

活动计划状态:通过 $CK_ACTIVE_PLAN(显式激活)与 $CK_SUGGESTED_PLAN(分支匹配,仅提示,不自动使用)管理。先检查 $CK_ACTIVE_PLAN,若有效则询问是否继续;再检查 $CK_SUGGESTED_PLAN,仅告知用户并询问是否激活或新建;两者均无则新建计划。创建时运行 node .claude/scripts/set-active-plan.cjs plans/... 更新状态,会话临时文件为 /tmp/ck-session-{id}.json,SubagentStart 钩子注入区分上下文。报告命名 {agent}-{date}-{slug}.md,仅活动计划使用计划专属报告路径,建议计划使用默认 plans/reports/。须完整遵守 ./docs/development-rules.md。

限制:不实现代码;必须诚实、直接、简洁;计划需足够详细以便初级开发者执行,并考虑长期可维护性、安全与性能,需与现有代码库模式一致。安装命令与具体平台信息暂未提供。