workflow-enforcer-skill

在所有项目中强制执行工作流规范：确保 Claude 在回复前检查是否有专用 Agent、宣布技能或 Agent 的使用情况，并为多步骤任务创建 TodoWrite 待办事项。此技能会在每个会话中自动激活，以保持一致的质量和工具使用方式。

<quick_start> 回复任何请求之前：

1. 检查 Agent：是否有适用于此任务的专用 Agent？
2. 宣布使用情况： “我将使用 [agent] 来 [action]”
3. 创建待办事项：对多步骤工作使用 TodoWrite
4. 跟踪进度：标记为 in_progress → completed

请求	Agent
修复 Bug	debugging-toolkit:debugger
代码审查	code-documentation:code-reviewer
编写测试	unit-testing:test-automator
</quick_start>

<success_criteria> 满足以下条件即表示工作流执行成功：

• 为每项适用任务识别并使用专用 Agent
• 开始工作前宣布 Agent 的使用情况
• 对所有多步骤任务（3 步以上）使用 TodoWrite
• 使用 in_progress 和 completed 状态跟踪进度
• 不以任何理由跳过 Agent（例如“这很简单”“只是快速修复”） </success_criteria>

<mandatory_protocol> 回复任何用户请求之前，必须完成以下检查清单：

1. 检查专用 Agent —— 这类任务是否有适用的 Agent？
2. 宣布使用情况 —— “我将使用 [agent] 来 [action]”
3. 创建待办事项／任务 —— 对多步骤工作使用 TaskCreate（首选）或 TodoWrite
4. 跟踪进度 —— 开始前标记为 in_progress，完成后标记为 completed

快速参考

用户请求	要使用的 Agent
修复 Bug／错误	debugging-toolkit:debugger
代码审查	code-documentation:code-reviewer
编写测试	unit-testing:test-automator
优化性能	performance-engineer
安全审计	security-auditor
部署／CI/CD	deployment-engineer
编写文档	docs-architect
重构代码	legacy-modernizer
构建 AI 功能	ai-engineer
生产环境事故	incident-responder

完整的 70 多个 Agent 目录请参阅 reference/agents-catalog.md。

使用方法

第 1 步：识别任务类型

为请求分类：

• 调试？→ 调试 Agent
• 代码审查？→ 审查 Agent
• 测试？→ 测试自动化 Agent
• 性能？→ 性能工程师
• 安全？→ 安全审计员
• 部署？→ 部署工程师

第 2 步：宣布

开始工作之前：

“我将使用 [agent-name] 来 [what you're doing]”

示例：

• “我将使用 debugging-toolkit:debugger 来追踪此身份验证错误”
• “我将使用 python-development:python-pro 来重构这段异步代码”

第 3 步：创建待办事项／任务

对于多步骤任务，使用 TaskCreate（首选——可呈现实时 UI 加载动画）或 TodoWrite（备用）：

TaskCreate（原生进度 UI）：

1. 将工作拆分为具体事项
2. 为每个事项使用 TaskCreate({ subject: "...", activeForm: "..." })
3. 开始前使用 TaskUpdate({ taskId, status: "in_progress" }) → 显示加载动画
4. 完成后使用 TaskUpdate({ taskId, status: "completed" }) → 显示勾选标记
5. 对有先后依赖关系的任务使用 addBlockedBy

TodoWrite（更简单的文本形式）：

1. 将工作拆分为具体事项
2. 使用 TodoWrite 创建列表
3. 开始前标记为 in_progress，完成后标记为 completed

第 4 步：遵循 Agent 规范

每种 Agent 都有自己的方法：

• TDD Agent → 先编写测试
• 调试 Agent → 系统性分析根本原因
• 代码审查 Agent → 遵循审查清单
• 部署 Agent → 遵循部署规程

</mandatory_protocol>

应避免的常见借口

如果你有以下任何想法，请立即停止并使用合适的 Agent：

• “这很简单，我不需要 Agent”
• “我就快速修一下”
• “我可以手动调试”
• “这不需要正式审查”
• “我先跳过测试”

正确的想法：“我应该为这项任务使用哪种专用 Agent？”

指南

• 此技能适用于每个会话、每个项目、每项任务
• 没有例外，没有借口，没有捷径
• 如有疑问，请查看 reference/agents-catalog.md

写入结果附加文件

最后一步，将内容写入 ~/.claude/skill-analytics/last-outcome-workflow-enforcer-skill.json：

{"ts":"[UTC ISO8601]","skill":"workflow-enforcer-skill","version":"1.0.0","variant":"default",
 "status":"[success|partial|error]","runtime_ms":[estimated ms from start],
 "metrics":{"checks_performed":[n],"agents_recommended":[n],"violations_caught":[n]},
 "error":null,"session_id":"[YYYY-MM-DD]"}

如果某些阶段失败但仍有结果，请使用状态 "partial"。仅当没有生成任何输出时，才使用 "error"。 </mandatory_protocol>