ai-sdlc-evidence-council
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chineseai-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: and
evidence-council.md_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 and
--quick-flow; full flow takes precedence.--full-flow - 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 with
ai-sdlc-handoff/v1,result,blockers, andnext_required; every action includesnext_optional,reason, andcommand.expected_artifact - Do not create ,
summary.txt, or panel-authored source patches.*-summary.txt - 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 as read-only.
authority.authoritative_artifacts - 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 before council orchestration.
<feature-root>/_ai_sdlc/state.toon - Council is optional review evidence and does not add a core lifecycle stage.
- is read-only;
--state-checkand--begin-stateare rejected.--complete-state - 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 using schema
artifact_metadata.ai-sdlc-evidence-council-metadata/v1 - Include for
metatags,ai-sdlc, the execution mode, andevidence-council.review - Record feature, workspace, flow mode, authority owner, evidence traces, and status.
- Markdown开头使用,遵循
artifact_metadataschema。ai-sdlc-evidence-council-metadata/v1 - 包含:
metatags、ai-sdlc、执行模式和evidence-council。review - 记录功能、工作区、流程模式、权威负责人、证据跟踪和状态。
0.7 Specs Index
0.7 规范索引
- Read the relevant or
specs/_ai_sdlc/specs-index.toonbefore targeted evidence reads.specs-refiniment/_ai_sdlc/specs-index.toon - Refresh matching or
specs/specs-index.mdonly after the final report write.specs-refiniment/specs-index.md - 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 before creating panel input.
references/council-contract.md - Read before running either mode.
references/orchestration-protocol.md - Use to enforce mode honesty, evidence links, ownership, and authority-safe output routing.
scripts/evidence_council.py
- 在创建评审组输入前,先读取。
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 toonbash
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 toonPurpose
目的
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
步骤
- Define topic, decision boundary, authority owner, and read-only artifacts.
- Select simulated or independent mode honestly.
- In simulated mode, apply distinct registered quality lenses sequentially and label them simulated.
- In independent mode, dispatch isolated reviewer executions through the host's real agent/subagent mechanism; if unavailable, stop with a blocker.
- Give reviewers evidence-only prompts and prohibit authoritative writes.
- Collect raw reviewer outputs and synthesize without erasing conflicts.
- Validate evidence IDs, reviewers, owners, and next actions.
- Write only the canonical council report pair and hand proposals to owners.
- 定义主题、决策边界、权威负责人和只读工件。
- 诚实地选择模拟或独立模式。
- 在模拟模式下,依次应用不同的已注册质量视角,并标记为模拟。
- 在独立模式下,通过主机的真实代理/子代理机制调度独立评审执行;若不可用,则以阻塞状态终止。
- 为评审人员提供仅含证据的提示,禁止修改权威内容。
- 收集原始评审输出并进行综合,不消除分歧。
- 验证证据ID、评审人员、负责人和后续操作。
- 仅写入标准评审报告对,并将提案提交给负责人。
Output Spec
输出规范
ai-sdlc-evidence-council/v1Quality 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 values produced
by actual isolated runs. Three role labels generated in one response are valid
only as , never .
execution_idsimulatedindependent有效的独立评审组记录使用由实际独立运行生成的三个不同值。在单个响应中生成的三个角色标签仅在标记为时有效,绝不能标记为。
execution_idsimulatedindependentEdge 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 after owners accept a proposal that changes delivery truth.
$ai-sdlc-change-impact
- 禁止评审人员编辑权威工件、状态、政策或决策。
- 若无独立执行,不得声称评审人员具有独立性。
- 不得将多数意见转化为接受权限。
- 不得隐藏分歧、异议、缺失证据或未回答问题。
- 当负责人接受改变交付真理的提案后,使用。
$ai-sdlc-change-impact