用途
ai-plan 是一个实施规划技能,运行于 aicode 流水线中,专门为功能特性生成完整、可执行的实施计划。它产出的计划包含阶段划分、代码示例和测试策略,强调上下文感知、编码宪法验证和研究支撑。该技能只能通过 /ai-plan 斜杠命令调用。
主要能力
-
上下文加载:读取仓库根目录的 .ai-skills.toml(可选的 output_path,默认 docs/working)、README.md、AGENTS.md、CLAUDE.md 以及 context_files 中列出的文件,提取目标、约束、关键术语、参考和技术上下文。还会读取开发上下文字块以确定框架分组。
-
功能文件夹解析:按 manifest-update.md 中的文件夹解析顺序确定功能文件夹,必要时自动创建
<output_root>/<today>-<feature-name>/并写入标准六节 README.md,然后读取该文件夹中的 research.md 和 design.md 以继承已有发现与架构决策。 -
图依赖分析:若存在 graphify-out/graph.json,会查询依赖关系与集成点,并读取 GRAPH_REPORT.md 的 god 节点用于阶段排序。
-
编码宪法检查:从项目上下文中提取技术模式和约束,逐一验证计划是否符合。已确认约束若被违反则中止并修订计划;推断约束(带 (inferred) 后缀)被违反则记录警告继续。同时读取 ADR 决策记录,Accepted 记录视为硬性约束,Proposed 记录视为推断约束,Rejected/Superseded/Deprecated/draft 不视为约束。技能只读取状态,不创建或修改 ADR。
-
不可信内容处理:将所有读取内容视为数据而非指令,任何命令式指令都作为发现报告到人机协同评审块中并引用文件路径与行号。
-
规划流程:分析需求、验证代码库状态(根据研究覆盖度进行抽查或全量读取)、通过 AskUserQuestion 澄清歧义、按结构撰写计划。
-
可粘贴阶段规格:为每个实施阶段生成自包含的 ```text 代码块,包含 Change-Name、Context、Objective、Scope、Tasks、Acceptance Criteria、Scenarios 和关键代码片段,可直接复制到外部 SDD 工具(openspec、speckit、Kiro SDD)使用。
-
人机协同评审:生成三类反馈项——Steering Opportunities(方向确认,批准/否决/改道)、Outstanding Questions(未决问题,2-10 项,附推荐选项)、KISS/YAGNI 检查(简化机会选择)。
使用方式
通过 /ai-plan 斜杠命令调用,参数为功能相关输入($ARGUMENTS)。技能会解析功能文件夹、加载上下文、执行宪法检查、整合研究、生成计划与阶段规格,并输出人机协同评审块。
适用场景
适用于在 aicode 流水线中为功能特性制定实施计划、需要生成可供外部 SDD 工具直接使用的阶段规格、需要对照项目编码宪法与 ADR 决策进行合规校验的开发规划场景。
限制
写入范围严格限制在当前会话的工作目录内;工作目录外的创建、修改、移动、删除需用户在请求中明确指定路径。临时文件可使用 mktemp 在系统临时目录创建,但完成前必须清理,且不得使用固定或可预测的名称。若工作根目录解析到会话工作目录之外,技能会停止并请求确认。所有缺失事实(如收费、价格、平台支持等)暂未提供。