SuperAPI AI 工具集

ac-plan

通用与其它

查看项目

更新于 10-16 08:49

技能介绍

用途:ac-plan 是 yz0812/ai-dev-toolkit 中的规划命令,接收 $ARGUMENTS 作为规划任务,先检索上下文,再生成可执行实施计划。其核心是“仅规划”:允许读取上下文和写入 .claude/plan/*.md 计划文件,但禁止修改产品代码。

主要能力:与工具交互用英语、与用户交互用中文;规划主权归属 Claude 主线程,最终方案选择、计划整合与计划文件写入均由主线程完成。按需启用 subagents(如 Agent 工具的 Explore 负责只读检索与结构摸排,Plan 负责方案拆解与路线分析),适用于开放式代码库搜索、跨目录跨模块摸排、并行比较多个实现路径;已知文件路径、单文件小改动、上下文明确的简单任务不适用。subagents 仅返回结论、证据与定位信息,只读协作,不直接输出最终计划。

使用方式:工作目录使用当前工作目录绝对路径{{WORKDIR}};若通过 /add-dir 添加多个工作区,先用 Glob/Grep 确定相关工作区,无法确定时用 AskUserQuestion 询问。流程分三阶段:Phase 1 需求增强与范围收敛(结构化目标、约束、范围、验收标准,模糊时先澄清);Phase 2 上下文检索(直接检索或并行 subagents 调研,做完整性检查,禁止基于假设出计划);Phase 3 主线程分析并生成计划,写入 .claude/plan/<功能名>.md,包含任务类型、技术方案、实施步骤、关键文件、风险与缓解等,随后向用户展示计划并提示审查或执行。

限制:不执行任何代码变更;不允许描述或执行第三方工具调用语法;不调用外部模型、后台任务、会话复用或额外 Bash 编排;不问 Y/N 自动执行;不自动调用 /ac-execute;计划中不得包含外部会话标识或要求会话交接。修改计划时按用户反馈更新同一文件并重新展示;迭代版本可保存为 <功能名>-v2.md、-v3.md。计划文件写入应在向用户展示计划前完成,Phase 3 后立即终止当前回复。