coding-agent-pm

编码 Agent 项目管理

当人类正在准备、委派、审查或恢复由 Claude Code、Codex、OpenClaw 或其他编码 Agent 完成的实现工作时，请使用此技能。

何时使用此技能

• 你需要将模糊的实现请求转化为范围明确的 Agent 任务。
• 你要向一个或多个编码 Agent 分配工作，并需要明确文件归属。
• 你正在审查 Agent 的差异，检查范围偏移、回归问题或遗漏的验证。
• 编码 Agent 陷入停滞、过度编辑，或返回了难以信任的结果。

此技能的作用

1. 用一句话定义交付结果。
2. 明确范围：负责的文件或模块、排除的文件或模块，以及禁止的破坏性操作。
3. 在开始实现前收集相关项目背景。
4. 编写可直接检查的验收标准。
5. 要求在最终交付前运行验证命令或进行手动检查。
6. 在接受工作前审查差异。

分配规则

• 让任务简洁、具体且范围明确。
• 说明 Agent 是否可以编辑文件，还是只能检查和制定计划。
• 明确代码更改的归属边界。
• 告知 Agent 不要还原无关的用户工作。
• 优先采用项目现有模式，而非引入新的抽象。
• 要求最终回复包含更改的文件、运行的检查、检查结果和剩余风险。

Agent 任务说明模板

# Agent Brief

## Outcome
Ship:

## Scope
Owned files/modules:

Do not edit:

Forbidden actions:
- Do not run destructive git commands.
- Do not revert unrelated user changes.

## Context
Relevant files:

Existing patterns to follow:

## Acceptance Criteria
- [ ] 
- [ ] 
- [ ] 

## Validation
Run:

Manual checks:

## Final Response Must Include
- Files changed
- Validation run and result
- Remaining risks or follow-ups

审查清单

按以下顺序审查：

1. 行为错误或回归问题。
2. 遗漏的验收标准。
3. 缺失的测试或薄弱的验证。
4. 范围偏移和无关重构。
5. 安全、隐私或破坏性命令风险。

如果 Agent 偏离了方向，请停止新的编辑，并让它将每项更改与原始验收标准对应起来。

恢复提示词

当编码 Agent 的工作难以信任时，请使用：

Pause implementation. Map every changed file and every material change back to the original acceptance criteria. For each change, mark it as required, optional, or unrelated. Do not edit files until this map is complete.

示例

用户：“让编码 Agent 添加 OAuth 登录。”

更好的任务分配：

Outcome: Add GitHub OAuth login to the existing auth flow.

Scope:
- Own: src/auth/*, src/routes/login.tsx, tests/auth/*
- Do not edit: billing, onboarding, database migrations unless a failing test proves it is required

Acceptance criteria:
- [ ] Existing email login still works.
- [ ] GitHub login creates or links a user through the existing auth service.
- [ ] Auth errors render through the existing form error pattern.
- [ ] Tests cover success, denied OAuth, and existing linked account.

Validation:
- npm test -- auth
- npm run lint

提示

• 负责的文件集越小，Agent 的结果通常越好。
• 对共享模块或高风险模块，明确列出“不要编辑”的清单。
• 优先采用验收标准，而不是冗长的实现说明。
• 将验证视为任务的一部分，而非后续事项。