用途
Codebase Singularity 用于在代码库中进行可靠的理解与变更。它提供一套可重复的工作流程、护栏和验证关卡，目标是在动手改动前建立对仓库的准确认识，并在改动后以证据确认结果。适用于需要控制风险、明确边界、可验证的代码修改任务。
主要能力
- 可重复工作流：按“准备（Prime）—总结（Summarize）—规划（Plan）—变更（Change）—验证（Validate）—收尾（Wrap up）”推进。
- 输入收集：需要仓库路径、任务目标、约束（避免触碰的文件、时间或风险限制、API 稳定性）、验证命令（测试、lint、构建或针对性检查）以及风险容忍度。
- 准备阶段：列出文件、阅读 README、检查入口点。
- 总结阶段：说明仓库形态以及变更应归属的位置；若有歧义则提问。
- 规划阶段：写出包含成功标准和验证步骤的简短计划。
- 变更阶段：实现最小可行补丁，避免无关重构。
- 验证阶段：运行所请求的命令或最接近可用的命令，并记录结果。
- 收尾阶段：报告变更、证据、风险和后续步骤。
- 成熟度分级：
- 第 1 级：仅准备。进行准备、总结，遇到歧义即停止。
- 第 2 级：专门角色 + 验证。加入角色提示（如 test_writer、docs_fetcher、reviewer），并要求每个角色都有验证步骤。
- 第 3 级：工具扩展。声明所需工具或服务及预期输出，优先使用工具而非猜测（例如查询 schema 而不是推断）。
- 第 4 级：闭环自主。运行循环：请求 -> 验证 -> 解决；加入硬性退出条件：最大迭代次数、进展证据、重复失败后停止。
- 护栏：保持差异小；始终验证，若无法验证则说明并提议安全的下一步；在广泛重构或扩大范围前先询问。
- 模板：内置“安全修复（Safe bugfix）”和“新增功能（Add a feature）”两种模板，规定目标、约束、验证、退出条件和交付物。
使用方式
按工作流步骤依次执行：先收集输入，再准备、总结、规划、变更、验证、收尾。根据任务需要选择成熟度等级：简单任务用第 1 级；需要角色分工和验证用第 2 级；需要声明工具或服务用第 3 级；需要自主循环并用硬性退出条件控制用第 4 级。可直接套用模板，例如安全修复模板要求“以最小改动修复 <bug>，不修改公共 API，避免触碰 <paths>，运行 ... 并粘贴输出，2 次失败尝试后停止并总结假设与日志，交付补丁 + 说明 + 风险”；新增功能模板要求“新增 <feature>，范围限于 <module>，不新增依赖，运行 ...，交付补丁 + 测试 + 简短文档更新”。
适用场景
- 需要可靠、可验证地理解和修改代码库的开发任务。
- 希望限制改动范围、避免无关重构的场景。
- 需要按风险容忍度选择不同自动化程度的场景（从仅准备到闭环自主）。
- 安全修复缺陷或受控地新增功能。
限制
- 具体的安装命令、收费模式、价格、支持平台、运行环境要求及实际效果，资料中暂未提供。
- 验证依赖用户提供或可用的验证命令，若无法验证需明确说明并提议安全的下一步。
- 第 4 级的闭环自主需要配置硬性退出条件（最大迭代、进展证据、重复失败停止），否则不适用。