ai-sdlc-evidence-council

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

ai-sdlc-evidence-council: Authority-Safe Review Orchestration

ai-sdlc-evidence-council:权威安全的评审编排

Optional review capability, not required by the core module. Every rule below is important to follow. None of it can be skipped. A council advises accountable owners; it never becomes approval authority.
可选评审能力,核心模块不强制要求。 以下每条规则都必须遵守,无一例外。 评审委员会为负责的负责人提供建议,但绝不拥有审批权限。

0. Skill Card

0. 技能卡片

  • Skill name:
    ai-sdlc-evidence-council
  • Primary audience: Delivery, Architecture, QA, Dev, BA
  • Supporting audience: PM, UX, Research, Security
  • Audience tags: Delivery, Architecture, QA, Dev, BA, PM
  • SDLC stage: Cross-lifecycle high-impact review
  • Purpose: Combine multiple evidence perspectives while preserving authority.
  • Output:
    evidence-council.md
    and
    _ai_sdlc/evidence-council.toon
  • 技能名称:
    ai-sdlc-evidence-council
  • 主要受众:交付、架构、QA、Dev、BA
  • 支持受众:PM、UX、研究、安全
  • 受众标签:交付、架构、QA、Dev、BA、PM
  • SDLC阶段:跨生命周期高影响评审
  • 目的:在保留权威的前提下整合多个证据视角。
  • 输出:
    evidence-council.md
    _ai_sdlc/evidence-council.toon

0.1 Required Inputs

0.1 必需输入

  • Owning feature root and review topic.
  • Council input using
    ai-sdlc-evidence-council-input/v1
    .
  • Named authoritative artifact owner and exact evidence anchors.
  • Host support for isolated reviewer executions when mode is
    independent
    .
  • 所属功能根目录和评审主题。
  • 使用
    ai-sdlc-evidence-council-input/v1
    的评审委员会输入。
  • 指定的权威工件负责人和确切的证据锚点。
  • 当模式为
    independent
    时,主机支持独立评审执行。

0.2 Clarification Rules

0.2 澄清规则

  • Ask when review question, authority owner, panel scope, or decision boundary is unclear.
  • Label simulated and independent modes exactly; never imply independence.
  • Preserve reviewer conflict and uncertainty instead of forcing consensus.
  • Do not infer acceptance from reviewer count or apparent agreement.
  • 当评审问题、权威负责人、评审组范围或决策边界不明确时,需询问确认。
  • 准确标记模拟和独立模式;绝不暗示独立性。
  • 保留评审人员的分歧和不确定性,而非强制达成共识。
  • 不要从评审人员数量或表面共识推断接受结果。

0.2.1 Flow Mode Flags

0.2.1 流程模式标志

  • Support
    --quick-flow
    and
    --full-flow
    ; full flow takes precedence.
  • Quick flow may use labeled simulated reviewers and focused evidence.
  • Full flow requires at least three reviewers, two roles, and populated evidence.
  • Independent mode requires unique independent execution IDs for every reviewer.
  • 支持
    --quick-flow
    --full-flow
    ;全流程优先级更高。
  • 快速流程可使用标记化模拟评审人员和聚焦证据。
  • 全流程要求至少三名评审人员、两个角色以及完整的证据。
  • 独立模式要求每个评审人员拥有唯一的独立执行ID。

0.3 Output Rules

0.3 输出规则

  • Return mode, panel identity, agreements, conflicts, proposals, unresolved questions, blockers, and output paths directly in the Codex response.
  • Before the final response, emit
    ai-sdlc-handoff/v1
    with
    result
    ,
    blockers
    ,
    next_required
    , and
    next_optional
    ; every action includes
    reason
    ,
    command
    , and
    expected_artifact
    .
  • Do not create
    summary.txt
    ,
    *-summary.txt
    , or panel-authored source patches.
  • Every synthesis row requires evidence and named contributing reviewers.
  • 在Codex响应中直接返回模式、评审组身份、共识、分歧、提案、未解决问题、阻塞点以及输出路径。
  • 在最终响应前,发送包含
    result
    blockers
    next_required
    next_optional
    ai-sdlc-handoff/v1
    ;每个操作需包含
    reason
    command
    expected_artifact
  • 不要创建
    summary.txt
    *-summary.txt
    或评审组编写的源代码补丁。
  • 每条综合记录都需要证据和指定的贡献评审人员。

0.4 Artifact Routing

0.4 工件路由

  • Write
    <feature-root>/evidence-council.md
    .
  • Write
    <feature-root>/_ai_sdlc/evidence-council.toon
    .
  • Treat all paths in
    authority.authoritative_artifacts
    as read-only.
  • Route accepted proposals later through the artifact-owning workflow.
  • 写入
    <feature-root>/evidence-council.md
  • 写入
    <feature-root>/_ai_sdlc/evidence-council.toon
  • authority.authoritative_artifacts
    中的所有路径视为只读。
  • 之后通过工件所属工作流路由已接受的提案。

0.5 Feature State Machine

0.5 功能状态机

  • Read
    <feature-root>/_ai_sdlc/state.toon
    before council orchestration.
  • Council is optional review evidence and does not add a core lifecycle stage.
  • --state-check
    is read-only;
    --begin-state
    and
    --complete-state
    are rejected.
  • Only owning lifecycle skills can change state or authoritative artifacts.
  • 在评审委员会编排前读取
    <feature-root>/_ai_sdlc/state.toon
  • 评审委员会是可选的评审证据,不会添加核心生命周期阶段。
  • --state-check
    为只读;
    --begin-state
    --complete-state
    将被拒绝。
  • 只有所属生命周期技能可以更改状态或权威工件。

0.6 Artifact Metadata And Metatags

0.6 工件元数据和元标签

  • Markdown starts with
    artifact_metadata
    using schema
    ai-sdlc-evidence-council-metadata/v1
    .
  • Include
    metatags
    for
    ai-sdlc
    ,
    evidence-council
    , the execution mode, and
    review
    .
  • Record feature, workspace, flow mode, authority owner, evidence traces, and status.
  • Markdown开头使用
    artifact_metadata
    ,遵循
    ai-sdlc-evidence-council-metadata/v1
    schema。
  • 包含
    metatags
    ai-sdlc
    evidence-council
    、执行模式和
    review
  • 记录功能、工作区、流程模式、权威负责人、证据跟踪和状态。

0.7 Specs Index

0.7 规范索引

  • Read the relevant
    specs/_ai_sdlc/specs-index.toon
    or
    specs-refiniment/_ai_sdlc/specs-index.toon
    before targeted evidence reads.
  • Refresh matching
    specs/specs-index.md
    or
    specs-refiniment/specs-index.md
    only after the final report write.
  • Never update indexes for panel scratch outputs.
  • 在读取目标证据前,先读取相关的
    specs/_ai_sdlc/specs-index.toon
    specs-refiniment/_ai_sdlc/specs-index.toon
  • 仅在最终报告写入后刷新匹配的
    specs/specs-index.md
    specs-refiniment/specs-index.md
  • 永远不要为评审组临时输出更新索引。

References

参考资料

  • Read
    references/council-contract.md
    before creating panel input.
  • Read
    references/orchestration-protocol.md
    before running either mode.
  • Use
    scripts/evidence_council.py
    to enforce mode honesty, evidence links, ownership, and authority-safe output routing.
  • 在创建评审组输入前,先读取
    references/council-contract.md
  • 在运行任一模式前,先读取
    references/orchestration-protocol.md
  • 使用
    scripts/evidence_council.py
    来确保模式真实性、证据链接、所有权和权威安全的输出路由。

Script Usage

脚本用法

bash
python3 skills/ai-sdlc-evidence-council/scripts/evidence_council.py specs/payments --input /tmp/council.json --emit --quick-flow
python3 skills/ai-sdlc-evidence-council/scripts/evidence_council.py specs/payments --input /tmp/council.json --write --full-flow --format toon
bash
python3 skills/ai-sdlc-evidence-council/scripts/evidence_council.py specs/payments --input /tmp/council.json --emit --quick-flow
python3 skills/ai-sdlc-evidence-council/scripts/evidence_council.py specs/payments --input /tmp/council.json --write --full-flow --format toon

Purpose

目的

Gain the challenge value of multiple perspectives without fictional consensus, vendor-specific orchestration assumptions, or panel authority over source truth.
在不产生虚构共识、供应商特定编排假设或评审组对源真理拥有权限的前提下,获得多视角带来的挑战价值。

Inputs

输入要求

  • Name the authority owner and authoritative artifacts before reviewer work.
  • Give reviewers bounded roles and isolated execution IDs in independent mode.
  • Anchor evidence to feature-relative paths and positive lines.
  • Synthesize agreements, conflicts, proposals, and unresolved questions separately.
  • 在评审人员开展工作前,指定权威负责人和权威工件。
  • 在独立模式下,为评审人员分配有限角色和独立执行ID。
  • 将证据锚定到功能相对路径和具体行。
  • 分别综合共识、分歧、提案和未解决问题。

Steps

步骤

  1. Define topic, decision boundary, authority owner, and read-only artifacts.
  2. Select simulated or independent mode honestly.
  3. In simulated mode, apply distinct registered quality lenses sequentially and label them simulated.
  4. In independent mode, dispatch isolated reviewer executions through the host's real agent/subagent mechanism; if unavailable, stop with a blocker.
  5. Give reviewers evidence-only prompts and prohibit authoritative writes.
  6. Collect raw reviewer outputs and synthesize without erasing conflicts.
  7. Validate evidence IDs, reviewers, owners, and next actions.
  8. Write only the canonical council report pair and hand proposals to owners.
  1. 定义主题、决策边界、权威负责人和只读工件。
  2. 诚实地选择模拟或独立模式。
  3. 在模拟模式下,依次应用不同的已注册质量视角,并标记为模拟。
  4. 在独立模式下,通过主机的真实代理/子代理机制调度独立评审执行;若不可用,则以阻塞状态终止。
  5. 为评审人员提供仅含证据的提示,禁止修改权威内容。
  6. 收集原始评审输出并进行综合,不消除分歧。
  7. 验证证据ID、评审人员、负责人和后续操作。
  8. 仅写入标准评审报告对,并将提案提交给负责人。

Output Spec

输出规范

ai-sdlc-evidence-council/v1
contains topic, mode, authority, panel, evidence, agreements, conflicts with positions, proposals, and unresolved questions.
Quality gate:
  • Pass when mode is honest, every synthesis row cites registered evidence and reviewers, conflicts preserve positions, and actionable rows name owner/next action.
  • Full flow fails below three reviewers, two roles, or one evidence anchor.
ai-sdlc-evidence-council/v1
包含主题、模式、权威、评审组、证据、共识、带立场的分歧、提案和未解决问题。
质量门:
  • 当模式真实、每条综合记录引用已注册证据和评审人员、分歧保留立场、可操作记录指定负责人/后续操作时,视为通过。
  • 若评审人员不足三名、角色不足两个或证据锚点不足一个,全流程视为失败。

Examples

示例

Valid independent panel rows use three different
execution_id
values produced by actual isolated runs. Three role labels generated in one response are valid only as
simulated
, never
independent
.
有效的独立评审组记录使用由实际独立运行生成的三个不同
execution_id
值。在单个响应中生成的三个角色标签仅在标记为
simulated
时有效,绝不能标记为
independent

Edge Cases

边缘情况

  • No consensus is a valid result; preserve owned unresolved questions.
  • A reviewer may support one agreement and one side of a conflict.
  • A proposal may be deferred or rejected but cannot be marked accepted by council.
  • If independent execution fails midway, report partial/blocked rather than simulating missing votes.
  • 无共识是有效的结果;保留归属的未解决问题。
  • 评审人员可能支持一项共识并站在分歧的某一方。
  • 提案可被推迟或拒绝,但评审委员会不能标记其为已接受。
  • 若独立执行中途失败,报告部分完成/阻塞状态,而非模拟缺失的投票。

Scope Boundary

范围边界

  • Do not let reviewers edit authoritative artifacts, state, policy, or decisions.
  • Do not claim reviewer independence without isolated executions.
  • Do not convert majority opinion into acceptance authority.
  • Do not hide conflicts, dissent, missing evidence, or unanswered questions.
  • Use
    $ai-sdlc-change-impact
    after owners accept a proposal that changes delivery truth.
  • 禁止评审人员编辑权威工件、状态、政策或决策。
  • 若无独立执行,不得声称评审人员具有独立性。
  • 不得将多数意见转化为接受权限。
  • 不得隐藏分歧、异议、缺失证据或未回答问题。
  • 当负责人接受改变交付真理的提案后,使用
    $ai-sdlc-change-impact