// 将 SDD-RIPER 方法论落地为严格可执行流程的重型 Harness 技能。用于辅助用户澄清最终目标、生成 codemap/context、拆分最小混沌单元、维护完整 spec、执行 RIPER 阶段门禁、阻塞高风险动作和沉淀可 new chat 恢复的本地任务轨迹。
| name | sdd-riper-one |
| description | 将 SDD-RIPER 方法论落地为严格可执行流程的重型 Harness 技能。用于辅助用户澄清最终目标、生成 codemap/context、拆分最小混沌单元、维护完整 spec、执行 RIPER 阶段门禁、阻塞高风险动作和沉淀可 new chat 恢复的本地任务轨迹。 |
git clean（包含任何参数，特别是 -fdx），防止用户未提交的工作区数据不可逆丢失。No Spec, No Code：未形成并持久化 Spec 前，不进入代码实现。No Approval, No Execute：未得到执行许可前，禁止进行环境修改或高风险变更。Spec is Truth：任何聊天决议或最新改动必须回源到 Spec，Spec 是唯一真相源。sdd-riper-one-light 的简单完整版。New Chat Startup Check：进入 new chat 或新项目会话时，先检查可见的项目/系统提示词入口是否存在、是否包含 sdd-riper-one / sdd-riper-one-light 路由；缺失时询问用户是否要新建或补充 AGENTS.md、CLAUDE.md、.github/copilot-instructions.md、.cursorrules 等默认文档；未获同意不得静默写入。references/sdd-riper-one-protocol.mdPre-Research -> RIPER，全程遵循 SDD 并持续维护 SpecNo Spec, No Code、Spec is Truth、Reverse Synccreate_codemap / build_context_bundle 是 Pre-Research 输入准备；sdd_bootstrap 是 RIPER 启动命令（进入 Research 第一步，同时完成 Pre-Research 收口）Research -> (Innovate, 可选) -> Plan -> Execute -> ReviewAGENTS.md 或用户定义。SDD 只在 Reverse Sync / Review / handoff / new chat / debug 收尾时识别 Project Sync Candidate，按已定义落点同步；未定义时先提出候选和建议，等待用户确认。详细边界按需读取 references/project-sync-boundary.md。AGENTS.md 定义。create_codemap -> build_context_bundle -> sdd_bootstrap -> Research -> (Innovate, 可选) -> Plan -> Execute -> Reviewsdd_bootstrap -> （按需补）create_codemap/build_context_bundle -> Research -> Plan -> Execute -> ReviewPlan Approved，禁止进入 ExecuteReview 不通过，回到 Research/Plan 修正SDD 是完整持久化上下文与记忆层：必须完整落盘、持续维护，但不作为每轮常驻输入RIPER 是审批驱动状态机：checkpoint 时必须让当前 phase、批准状态与下一步动作清晰可见在 checkpoint、执行前、阶段收尾、偏差暴露或 new chat 恢复时，先让模型用当前上下文自总结：
phaseapproval statusspec pathGoalDone / Key DecisionsIn Scope / Out of ScopeChecklistOpen QuestionsNext Action热摘要只用于当前轮聚焦，不替代 spec；与 spec 冲突时，永远以 spec 为准。它是比完整 spec 更轻的 recap checkpoint，用来防止当前 loop 上下文腐烂；除 checkpoint/恢复/高风险节点外，不机械重复这组字段。
Research -> Plan：Research Findings、关键事实、方案结论Plan -> Execute：File Changes、Signatures、原子 ChecklistExecute -> Review：Validation、实际改动摘要、偏差说明review_spec / review_execute 时，回读对应评审区块Change LogResearch 细节codemapcontext bundleMULTI / DEBUG / ARCHIVE 的完整扩展规则Feature Spec / Project Spec。普通开发任务默认维护 Feature Spec；项目级文件更新必须来自已确认的 Project Sync Candidate，并遵循项目定义的知识落点。phase 与 approval status 必须是显式状态，不允许根据语气、倾向或不完整表述推断Plan Approved，不进入 ExecuteReview 时必须基于 plan 与 validation，而不是只看聊天摘要spec path，让模型在 checkpoint 点先自总结当前状态review_spec 回读 Plan 区块，review_execute 回读 Plan + Validation + Review 区块Plan Approvedreferences/mode-selection.mdreferences/routing-map.mdreferences/minimum-chaos-unit.mdreferences/water-flow.mdreferences/anti-context-decay.mdreferences/skill-injection-check.mdreferences/project-sync-boundary.mdreferences/default-prompt-setup.mdreferences/script-map.mdMULTI / 多项目 / CROSS / SWITCH 时读 references/multi-project.md。create_codemap / build_context_bundle / sdd_bootstrap / review_spec / review_execute / archive 时读 references/commands.md。DEBUG / 排查 / 日志分析 / 验证功能 时读 references/sdd-riper-one-protocol.md 的 Debug 段或 references/usage-examples.md 的 Debug 示例。new chat / 换对话 / handoff / resume_pack / 续接 prompt / 上下文压缩 时调用 $new-chat-ready，并同步当前 spec 的 Resume / Handoff 区块。AGENTS.md 或用户定义落点同步，未定义时先建议并等待确认。references/workflow-quickref.md。references/script-map.md 和 references/archive-template.md。Open Questions、最近一次 Change Log / Validationcodemap / context bundle 按需读取，不作为每轮固定输入Innovate 可选：复杂任务建议 2-3 方案；小任务可跳过但要写原因Plan 必须可执行：文件路径 + 签名 + 原子 checklistPlan 后建议执行 review_spec；其 NO-GO 为建议项，不是强制门禁Review 必须按三轴评审并回写结论：Review Matrix、Overall Verdict、Plan-Execution Diffarchive，沉淀 human/llm 双视角知识references/routing-map.md（先看这个，决定读什么/调什么）references/sdd-riper-one-protocol.mdreferences/spec-template.mdreferences/workflow-quickref.mdreferences/usage-examples.mdreferences/archive-template.mdreferences/multi-project.md（多项目协作详细规则）references/commands.md（原生命令动作详细参数）references/script-map.md（可调用脚本入口）references/project-sync-boundary.md（项目知识沉淀与分流边界）$new-chat-ready（跨对话交接包与续接 prompt）面向 GPT-5.4 等强模型和熟练用户的轻量 AI Agent Harness / checkpoint-driven coding skill。默认用户已经把任务切到基本可执行的最小混沌单元；模型自行分解、探索与推进，人类通过最终目标、最小 spec、复述、checkpoint、证据验证与回写来低干扰控盘。
Prepare seamless new-chat handoff packs when a user wants to start a fresh chat, continue elsewhere, pause a long task, recover from context decay, recover a lost conversation from local Codex or Claude Code logs, preserve reusable project knowledge in Markdown, or hand work to another agent. Generates a durable handoff document, optional project-level Markdown updates such as AGENTS.md/README.md/PROJECT_SPEC.md/PROJECT_MEMORY.md, and a paste-ready next-chat prompt grounded in current task state, local conversation records, source files, specs, codemaps, validation evidence, open risks, and constraints.
Generate, update, or drift-check agent-facing CodeMaps as progressive code terrain indexes for projects, features, capabilities, functions, modules, or bug chains. Use when Codex needs to inspect an unfamiliar codebase, map a feature/capability from entry to effect, create or update `mydocs/codemap/*`, answer `create_codemap`, `MAP`, `PROJECT MAP`, code terrain, impact-map, "where should the agent look first", check whether existing CodeMaps are stale after a diff, or prepare SDD-RIPER Research without loading the whole repository into context.