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 修改后重新提交 | 重新评估修改内容 |
角色隔离检查
- • 当前会话未执行过 Author
- • 当前会话未执行过 Challenger
检测输出示例
code
检测结果: - proposal.md:存在 - Challenger 意见:存在(3 个风险点) - 角色隔离:✓ - 运行模式:首次裁决