AgentSkillsCN

devbooks-proposal-judge

devbooks-proposal-judge:对 proposal 阶段进行裁决(Judge),输出 Approved/Revise/Rejected 并写回 proposal.md 的 Decision Log。当用户说“裁决提案/提案评审/Approved Revise Rejected/decision log”等时,应运用此技能。

SKILL.md
--- frontmatter
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>:变更包目录根

执行前必须按以下顺序查找配置(找到后停止):

  1. .devbooks/config.yaml(如存在)→ 解析并使用其中的映射
  2. dev-playbooks/project.md(如存在)→ Dev-Playbooks 协议,使用默认映射
  3. project.md(如存在)→ template 协议,使用默认映射
  4. 若仍无法确定 → 停止并询问用户

关键约束

  • 如果配置中指定了 agents_doc(规则文档),必须先阅读该文档再执行任何操作
  • 禁止猜测目录根
  • 禁止跳过规则文档阅读

执行方式

  1. 先阅读并遵守:~/.claude/skills/_shared/references/AI行为规范.md(可验证性 + 结构质量守门)。
  2. 严格按完整提示词输出裁决:references/提案裁决提示词.md

上下文感知

本 Skill 在执行前自动检测上下文,确保角色隔离。

检测规则参考:skills/_shared/上下文检测模板.md

检测流程

  1. 检测 proposal.md 是否存在
  2. 检测是否有 Challenger 的质疑意见
  3. 检测当前会话是否已执行过 Author/Challenger 角色

本 Skill 支持的模式

模式触发条件行为
首次裁决无裁决记录综合评估提案和质疑,输出裁决
复议裁决Author 修改后重新提交重新评估修改内容

角色隔离检查

  • 当前会话未执行过 Author
  • 当前会话未执行过 Challenger

检测输出示例

code
检测结果:
- proposal.md:存在
- Challenger 意见:存在(3 个风险点)
- 角色隔离:✓
- 运行模式:首次裁决