/icode-skill

name: icode
description: 端到端编码工作流（步骤 0~6，含需求初稿、日志根因、验证、独立复评、学习与本地管理 UI），支持：/icode help, ui, install [--basic|--preview], init [--guide], log, start, fast, plan, review, merge, code, deepcheck, audit, crosscheck, patch, verify [--build] [--deploy] [--listen|--test] [--plan], doc, docx, limit, readme, ppt, learn [--project|--ticket|--since], study [--ticket|--library], status [--pending|--scan|--verdict], list [--all|--plain], bak, worktree --update/--close/--reopen/--merge。新建工单入口支持 --worktree opt-in

**版本**: v2.31.0

ICode 全流程编码工作流（步骤 0 + 1~6）

端到端编码工作流，将需求到交付拆解为严格步骤，每步可单独调用，方便你自行切换模型。**本文档是路由器**：内核规则内联，详细规则一律放 `steps/*.md` 与 `references/*.md`，需要时按路由表 Read（懒加载，省 token）。

• **步骤 0（可选）**：需求初稿对话，落档为 `00_init.md`；`init --guide` 派生新人指南
• **步骤 1~6**：拟定计划 → 审查 → 定稿 → 编码 → 复检 → 终审

> **主流程步骤真源（防误用，唯一真源 = `steps/` 目录，启动强制 Read）**：步骤编号 / 产物文件名 / `completed_steps` 合法值**一律以 `steps/*.md` 实时清单为准**（`ls steps/*.md` 完整列出，含主流程与辅助入口 log / doc / docx / limit / status / install / list / bak / verify / learn / study / crosscheck，及精简全流程入口 fast）——**本块仅示意，steps/ 演进后以目录为准，勿依赖写死**。`/icode start` / `/icode fast` / `/icode plan` 进入第一步**先 `ls steps/*.md`** 核对，不按"编码→测试→部署"直觉推断 > - 当前主流程示意（以 `ls steps/*.md` 为准）：`00_init → 01_plan → 02_review → 03_merge → 04_code → 05_deepcheck → 06_audit → 07_readme → 08_patch`；**不存在 `03_code` / `04_test` / `05_deploy`**（测试验证在 04_code 子段，部署/回归归 07_readme / 08_patch / verify） > - 辅助独立步骤（doc / docx / log / limit / status / install / list / bak / verify / learn / study / crosscheck）不参与 1~6 推进；**fast 为精简全流程（非辅助独立步骤）**——参与 1~6 但各步缩略（见命令表 fast 行） > - **强制**：产物命名 + `completed_steps` 写号**对照 `ls steps/*.md` 实时结果**（如入口含 `log` → 可写 `"log"`），不在清单 → 停下核对，禁止自造产物占位；steps/ 目录与本文档不一致时**以 steps/ 目录为准**

通用约定（对话语言）

**AI 对用户的回复一律使用中文**（提示 / 解释 / 报告 / 追问 / 总结 / 决策说明 / 输出行）。**工程内容保持原样、不翻译**：代码、标识符、产物文件名、命令、日志原文、报错原文、设备输出、配置字段值。仅当用户明确要求英文回复时切换。

> 适用所有 `/icode` 命令的会话交互与步骤内对用户的询问/报告；产物文件正文遵循既有中文风格撰写。

调用命令

正式工单产物保存在 `.icode_output/.icode_output_N/`（N 自动递增）；非工单命令按各自行指定隔离目录。**详细语义一律以 `steps/*.md` 为准，下表只给路由与关键 flag**：

| 命令 | 一句话用途 + 关键 flag | 创建目录？ | |------|------|-----------| | `[辅助]` `/icode help` | 输出使用流程示例与命令一览 | 否 | | `[管理]` `/icode ui` | 启动/复用本地 ICODE 工作台；全局项目/工单管理、手动/默认30秒自动刷新、设置和受控步骤执行 | 否 | | `[辅助]` `/icode install [--client claude\|codex\|codebuddy\|all] [--basic\|--preview]` | ICODE、宿主命令桥与 MCP 一键安装；`--basic` 跳过 MCP，`--preview` 零写入预览 | 否 | | `[入口]` `/icode log [零散信息...]` | 日志根因分析→转修复需求；版本基线门；TB 复用/批量/`--debug`/`--worktree`；对外简报 | ✅ 每次都新建（同 TB 单复用除外） | | `[入口]` `/icode init [--guide] [<需求或指南约束>]` | 常规：新建并产出 `00_init.md`；`--guide`：复用最新合格 init，刷新新人指南+审计 | 常规 ✅；guide 否 | | `[流程]` `/icode start <需求>` | 全流程：创建/复用目录 → 步骤1~6 串联；`--worktree` | ✅ 创建 / 复用 | | `[流程]` `/icode fast <需求>` | 精简全流程：plan→review(1轮无对抗)→merge→code→deepcheck(Reverse)→audit；`--worktree` | ✅ 创建 / 复用 | | `[流程]` `/icode plan <需求>` | 仅步骤1：拟定计划；`--worktree` | ✅ 创建 / 复用 | | `[流程]` `/icode review [N]` | 仅步骤2：多轮循环审查 + 独立质疑者对抗（N=软上限轮数，默认3） | 用最新目录 | | `[流程]` `/icode merge` | 仅步骤3：合并审查意见定稿 | 用最新目录 | | `[流程]` `/icode code` | 仅步骤4：落地编码实施（含 Code Review Fix 4 维度复检；O-6 用户自担验证豁免） | 用最新目录 | | `[流程]` `/icode deepcheck` | 仅步骤5：三阶段递进复检（Reverse→Fixed→Free；fast 只跑 Reverse） | 用最新目录 | | `[流程]` `/icode audit` | 仅步骤6：终极终审 + 统一修复 | 用最新目录 | | `[可选步骤7]` `/icode readme` | 一次性生成交付报告（自己看）+ `_brief.md` 跨领域简报（给其它模块/测试/产品） | 用最新目录 | | `[独立]` `/icode patch [问题或新需求...]` | 追加修改：轻量四段式；不改变 status；`--listen` 可在修改后自动监听 | 用最新目录 | | `[独立复评]` `/icode crosscheck [--ticket <id>\|<工单路径>]` | 用户自行换 Agent/模型后完整复评 completed 工单；项目内隔离、多轮追加、原工单与代码零回写 | 否（写 `.icode_output/.crosscheck/`） | | `[独立]` `/icode verify [--build] [--deploy] [--listen\|--test <target>] [自然语言]` / `/icode verify --plan [--ticket <id>]` | **分阶段构建/部署/监听/测试**：选项按顺序只执行各自阶段，可组合；无选项先识别自然语言意图。结果逐阶段记 `verification_runs`，不自动升级 delivery_verdict（[steps/verify.md](steps/verify.md)） | 否（无工单单独 build 只写工程构建报告；plan 只写派生报告） | | `[学习]` `/icode learn [--project <path>] [--ticket <id>] [--since <ISO-8601>]` | 从项目内观测生成复用/组合/增强/新建/工具化/no-action 建议，不直接创建或发布 Skill（[steps/learn.md](steps/learn.md)） | 否（写 `.icode_output/learn/` 派生报告） | | `[学习]` `/icode study [--ticket <id>] [--library <目录>] [主题]` | 从已写代码提炼通用技术文章，按卷/章保存在用户自己的知识库；源码溯源留在库外（[steps/study.md](steps/study.md)） | 否（写用户配置的知识库） | | `[工程]` `/icode doc [自然语言]` | 工程级知识库生成/维护（`project_docs/`+`module_docs/`）；doc_worklist 防中断丢进度 | 否（写全局） | | `[交付]` `/icode docx [自然语言]` | DOCX 交付：明确 Markdown 忠实转换，或将已有工单/知识库组织为交付 Word；自管运行时、结构验收、兼容 renderer 视觉验收 | 否（P0 同级；P1 写 `<工程根>/.icode_output/docx/`） | | `[配置]` `/icode limit [自然语言]` | 项目约束红线（主存+单 checkout 覆盖）；plan/log 前置硬基线 + `limit_checkpoint.md` 读留痕 | 否（写全局 limits/ + 工程根 limit.local/） | | `[交付]` `/icode ppt [自然语言]` | PPT 生成（4 类场景），16 套模板只换文字 | 否（写 `<工程根>/.icode_output/ppt/`） | | `[查询]` `/icode status` | 只读查状态；`--pending` 汇总验证债务；`--verdict` 可配 `--replacement`/`--dependency` 标注方向结论；`--scan` 批量扫证伪信号；`--validate` 产物集机器校验 | 否（仅 `--verdict` 写 metadata+索引；债务报告为派生产物） | | `[查询]` `/icode list [关键词] [--all] [--plain]` | 跨工程工单查找；`--all` 含 stale，`--plain` 禁用颜色 | 否（纯只读） | | `[备份]` `/icode bak [--project <path>]` | 工程工单手动备份到全局快照（删工程前安全网） | 否（写全局） | | `[生命周期]` `/icode worktree --update [--target <ref>]` | 受控迁移活动实现根到新基线（11 阶段状态机） | 否 | | `[生命周期]` `/icode worktree --close [--ticket <id>]` | 提交后收敛：G4 在线证据核验 → 分阶段 close_state 幂等推进 → 安全清理（`--ticket` 显式解析） | 否 | | `[生命周期]` `/icode worktree --reopen [--ticket <id>] [--target <ref>]` | 显式恢复已 close 工单（归档控制根受控解冻，先 reopen 再 patch） | 否 | | `[生命周期]` `/icode worktree --merge` | 刷新线上目标、全仓冲突预检、安全合并和复检；不自动 commit/push | 否（更新 remote refs；可 fast-forward 或保留未提交 merge） |

> **目录复用规则**（start/plan/fast 启动时）：检查最新 `.icode_output/.icode_output_N/`——入口态（`init_in_progress`/`log_done`）**有歧义一律问用户**（带参可能是补充旧需求也可能是新需求）；非入口态带参 → 直接新建；无参且无入口态可复用 → 报错提示。完整脚本与 `REUSE=2/0` 语义见 [references/dir_and_metadata.md](references/dir_and_metadata.md)「复用 / 创建新目录决策」。

> **`init --guide` 显式覆盖**：复用当前工作区最新合格初稿，不询问、不新建、不改状态，刷新 `deliverables/guide.md` 与审计；详见 [guide_contract.md](references/guide_contract.md)。

> **init/log 入口状态转换时机**：新工单先生成非空 ID 并经 `create` 原子