sdlc-dev-skills

Use this agent when a major project step has been completed and needs to be reviewed against the original plan and coding standards. Examples: <example>Context: The user is creating a code-review agent that should be called after a logical chunk of code is written. user: "I've finished implementing the user authentication system as outlined in step 3 of our plan" assistant: "Great work! Now let me use the code-reviewer agent to review the implementation against our plan and coding standards" <commentary>Since a major project step has been completed, use the code-reviewer agent to validate the work against the plan and identify any issues.</commentary></example> <example>Context: User has completed a significant feature implementation. user: "The API endpoints for the task management system are now complete - that covers step 2 from our architecture document" assistant: "Excellent! Let me have the code-reviewer agent examine this implementation to ensure it aligns with our plan and follows best practices" <commentary>A numbered step from the planning document has been completed, so the code-reviewer agent should review the work.</commentary></example>

Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

用于确认开发已完成，并确保所有测试/检查全部通过

Use when 需要从前端代码证据化产出“页面清单→功能点→业务流程→业务规则”，且项目路由入口不唯一、动态路由/权限/后端菜单复杂、团队容易脑补或遗漏证据链时。

Use when 你已经确定了 Discover 的范围（P0/P1/P2），现在需要快速建立 `.aisdlc/project/` 的 Level-0 北极星（memory）与 Level-1 地图层索引骨架（components/products），以便后续按模块补证据而不发生双写与漂移。

Use when 你需要把选中的模块（优先 P0）做成 `.aisdlc/project/components/{module}.md` 的单页模块 SSOT，并在同一页内建立 API/Data 契约的权威入口、不变量摘要、证据入口与结构化缺口（Evidence Gaps），以满足 Discover 的 DoD 门禁。

Use when 你要开始存量项目 Discover，但你还不清楚“哪些入口可作为证据（run/test/ci/contract/ops）”以及“应该先做哪些模块（P0/P1/P2）”，并且担心范围失控导致不可维护。

Use when 你已经有了 components 地图与若干模块页，现在需要收敛业务模块（products<=6）、固定运行/排障/回滚入口（ops）、并执行 DoD 门禁与增量 Discover（Delta Discover、stale 过期检测）来保证知识库可用且可维护。

Use when 需要对“已有代码的存量项目”做 Discover（逆向）并把仓库事实沉淀为 `.aisdlc/project/`，且你发现 AI/团队经常猜入口、猜边界、索引与细节双写、或缺证据链导致反复返工。

Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation

Use when completing tasks, implementing major features, or before merging to verify work meets requirements

Use when 需要在当前 Spec Pack 中检查文档是否存在待澄清/待确认/TBD/TODO 等高价值不确定点，并用“一次只问一个问题→立刻回写文档→必要时回到扫描”的循环把不确定性收敛。

Use when 需要在 sdlc-dev 的 Spec 流程中定位当前 spec pack（FEATURE_DIR）、避免在错误目录读写 requirements/*.md，或出现"看错上下文/写错文件/分支不符合规范"的问题。

Use when 需要在 Spec 级设计阶段执行 D1 research（产出 `{FEATURE_DIR}/design/research.md`），或面对关键不确定性/高风险点需要先验证而不是直接进入 D2；常见症状包括缺少证据支撑取舍、未知项被写成 TODO/待确认问题、在压力下想猜 FEATURE_DIR 或把调研写成实现细节。

Use when 需要为某个 Spec Pack 产出 D2 决策文档（RFC/Decision Doc），且必须强制消费项目知识库与 `{FEATURE_DIR}/requirements/solution.md#impact-analysis`；适用于在时间/权威压力下容易只读索引、跳过受影响模块/ADR 全文、静默忽略缺失输入或不写 `CONTEXT GAP`、以及遗漏“与现有系统对齐”自检的情况。

Use when 需要在 sdlc-dev 的 Spec Pack 中执行 I2（实现执行），以 `{FEATURE_DIR}/implementation/plan.md` 为唯一 SSOT 分批实现、运行最小验证、回写审计信息，并在批次检查点汇报；遇阻塞/澄清项立即停止。

Use when 需要在本仓库的 AI SDLC 流程中初始化新的 Spec Pack（创建三位编号分支与 `.aisdlc/specs/{num}-{short-name}` 目录），或在执行 `spec-init` 时不确定输入解析、短名称规则、UTF-8 BOM 文件路径传参、脚本调用方式与输出物。

Use when 一个 Spec Pack 已完成，需要把可复用资产晋升到 project SSOT（ADR/契约/ops/NFR/registry），且存在“整包复制污染 project / 跳过 spec-context / 把 merge-back 误当 git merge”的风险。

Use when 需要因需求重大问题而废弃/撤销当前 Spec Pack，并且必须删除对应 `.aisdlc/specs/{branch}` 目录与本地/远程分支，同时需要在执行删除前输出删除清单并要求用户二次确认。

Use when 需要在 sdlc-dev 的 Spec Pack 中执行 I1（实现计划），把 requirements/design 转成 `{FEATURE_DIR}/implementation/plan.md`（唯一执行清单与状态 SSOT），并为后续 I2 执行提供无歧义任务清单。

Use when 在 sdlc-dev 的 spec 分支上需要完成 R1（raw→solution）的需求澄清，但出现催促跳过澄清/跳过门禁、要求“一次问完”、或要求你直接给下一步路由结论等压力信号。

Use when 需要在 sdlc-dev 的产品需求 Spec 流程执行 R4（基于 requirements/prototype.md 生成可交互 Demo 工程），并需要避免跳过 spec-context、在缺少 prototype.md 或缺少可运行 Demo 工程根目录时仍继续、或自创页面/目录导致不可追溯与无法回流闭环。

Use when 需要在 sdlc-dev 的产品需求 Spec 流程执行 R2，将 requirements/solution.md 转写为可交付、可验收、可测试的 requirements/prd.md，且需要避免猜路径、在缺少 solution.md 时仍继续生成、或用“待确认问题/Open Questions”替代验证清单。

Use when 需要在 sdlc-dev 的产品需求 Spec 流程执行 R3（原型生成），基于 requirements/prd.md 产出 requirements/prototype.md（任务流+页面结构+ASCII线框+AC映射+走查脚本），并避免缺少上下文/缺少 PRD 仍继续生成、用 Open Questions 代替验证清单、或用非 ASCII 方式导致原型不可追溯与不可评审。

Use when 需要在 Spec Pack 的 verification 阶段创建“可直接粘贴到外部缺陷系统”的缺陷报告（不在 Spec Pack 内落盘 bug 文件），并将缺陷引用回写到 `{FEATURE_DIR}/verification/report-*.md`。

Use when 需要在 Spec Pack 的 verification 阶段产出 `{FEATURE_DIR}/verification/report-{date}-{version}.md`（测试报告），给出可交付结论并可追溯到用例与缺陷引用。

Use when 需要在 Spec Pack 的 verification 阶段生成或更新 `{FEATURE_DIR}/verification/test-plan.md`（测试计划），并要求严格门禁与可追溯。

Use when 需要在 Spec Pack 的 verification 阶段生成或更新 `{FEATURE_DIR}/verification/suites.md`（测试套件），把用例组织成可执行集合并定义阻断规则与执行顺序。

Use when 需要在 Spec Pack 的 verification 阶段生成或更新 `{FEATURE_DIR}/verification/usecase.md`（测试用例），默认以手工执行为准，并要求按统一模板生成且 AC 可追溯。

Use when 需要在 Spec Pack 的 verification 阶段生成/更新测试计划、用例、套件或测试报告，并要求严格门禁、可追溯落盘与不越权路由。

Use when executing implementation plans with independent tasks in the current session

Use when 需要在 sdlc-dev 仓库执行 AI SDLC（Spec Pack）流程、选择/串联需求侧（raw/solution/prd/prototype/demo）与实现侧（plan/execute/finishing）技能，并用门禁避免上下文漂移、写错目录或在压力下跳过关键步骤。