| name | devbooks-proposal-judge |
| description | devbooks-proposal-judge:对 proposal 阶段进行裁决(Judge),输出 Approved/Revise/Rejected 并写回 proposal.md 的 Decision Log。用户说"裁决提案/提案评审/Approved Revise Rejected/decision log"等时使用。 |
| recommended_experts | ["Product Manager","System Architect"] |
| allowed-tools | ["Glob","Grep","Read","Write","Edit"] |
DevBooks:提案裁决(Proposal Judge)
渐进披露
基础层(必读)
目标:明确本 Skill 的核心产出与使用范围。
输入:用户目标、现有文档、变更包上下文或项目路径。
输出:可执行产物、下一步指引或记录路径。
边界:不替代其他角色职责,不触碰 tests/。
证据:引用产出物路径或执行记录。
进阶层(可选)
适用:需要细化策略、边界或风险提示时补充。
扩展层(可选)
适用:需要与外部系统或可选工具协同时补充。
推荐 MCP 能力类型
- 代码检索(code-search)
- 引用追踪(reference-tracking)
- 影响分析(impact-analysis)
前置:配置发现(协议无关)
<truth-root>:当前真理目录根
<change-root>:变更包目录根
执行前必须按以下顺序查找配置(找到后停止):
.devbooks/config.yaml(如存在)→ 解析并使用其中的映射
dev-playbooks/project.md(如存在)→ Dev-Playbooks 协议,使用默认映射
project.md(如存在)→ template 协议,使用默认映射
- 若仍无法确定 → 停止并询问用户
关键约束:
- 如果配置中指定了
agents_doc(规则文档),必须先阅读该文档再执行任何操作
- 禁止猜测目录根
- 禁止跳过规则文档阅读
执行方式
- 先阅读并遵守:
~/.claude/skills/_shared/references/AI行为规范.md(可验证性 + 结构质量守门)。
- 严格按完整提示词输出裁决:
references/提案裁决提示词.md。
上下文感知
本 Skill 在执行前自动检测上下文,确保角色隔离。
检测规则参考:skills/_shared/上下文检测模板.md
检测流程
- 检测
proposal.md 是否存在
- 检测是否有 Challenger 的质疑意见
- 检测当前会话是否已执行过 Author/Challenger 角色
本 Skill 支持的模式
| 模式 | 触发条件 | 行为 |
|---|
| 首次裁决 | 无裁决记录 | 综合评估提案和质疑,输出裁决 |
| 复议裁决 | Author 修改后重新提交 | 重新评估修改内容 |
角色隔离检查
检测输出示例
检测结果:
- proposal.md:存在
- Challenger 意见:存在(3 个风险点)
- 角色隔离:✓
- 运行模式:首次裁决