spec-simplify-code
在保持行为不变的前提下,简化近期改动的代码以提升清晰度、复用、质量与效率。
ASCII 链路图
text
Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
|
v
spec-simplify-code
entry: standalone skill
type: standalone-skill基本信息
| 字段 | 内容 |
|---|---|
| Skill | spec-simplify-code |
| 类型 | standalone-skill |
| 研发链路位置 | Code |
| 当前入口 | standalone skill |
| 兼容别名 | 不适用 |
| Source | skills/spec-simplify-code/SKILL.md |
| Governance | src/cli/contracts/dual-host-governance/skills-governance.json(supported-host skills governance) |
描述
Simplify recently changed code for clarity, reuse, quality, and efficiency while preserving behavior. Use for tidy/refactor passes; use spec-debug for bugs.
Source 契约摘要
该 source skill 未声明标准 Workflow Contract Summary 小节;本页以 frontmatter、supported-host governance 和维护者补充元数据为准。
何时使用
- 需要对近期改动做 tidy/refactor 收尾。
- 代码可读性或复用需要提升。
工作步骤
- 读取 plan、task pack、bug report 或明确实现目标。
- 建立小步任务列表,按现有代码模式做最小必要修改。
- 运行聚焦验证、测试、构建、浏览器或平台检查。
- 把 diff、验证结果和剩余风险交给 review 或 knowledge 阶段。
输出
- 实现 diff、测试结果、构建输出、浏览器截图或运行证据。
- 必要时输出 blocked 原因,而不是扩大 scope。
Agent / Persona 列表
- 小任务通常 inline;大任务可按文件边界使用 serial 或 parallel workers。
- 调试、优化、UI、平台专项可引入对应 specialist agents,但 orchestrator 负责最终集成。
本 skill 在 source 中挂载了 3 个 skill-local 专家资产(agent 0 · persona 3),路径为 skills/spec-simplify-code/references/{agents,personas}/。跨 skill 复用时,详情页按文件名去重。
| 名称 | 类型 | 摘要 |
|---|---|---|
spec-code-quality-reviewer | persona | You are the Code Quality Reviewer. |
spec-code-reuse-reviewer | persona | You are the Code Reuse Reviewer. |
spec-efficiency-reviewer | persona | You are the Efficiency Reviewer. |
agent 详情页入口仍在
/reference/agents/*;完整按 skill 归属索引见 Agents 参考。persona 目前以 skill-local prompt 形式挂在所属 skill 下,不单独生成全局详情页。
边界
- 保持行为不变,不改功能语义。
- bug 修复请用 spec-debug。
源码校准
- 本页由
website/scripts/generate-skill-detail-pages.js从上游 source skill 生成。 - 当前入口、兼容别名与宿主投递 metadata 来自
src/cli/contracts/dual-host-governance/skills-governance.json。 - 当 source skill 或 governance contract 变化后,应重新运行
npm run reference:pages并执行npm run content:audit。
