agent-infra: Skill for Claude Code

分析任务

--agent 取值见 .agents/rules/task-management.md「合作者 token 规范」。

生命周期事件必须携带显式触发信息：普通技能调用使用 model；仅用户明确要求时使用 human。{request-id} 是本任务与本轮产物的稳定单行标识，{reason-code} 使用 user-request、new-requirement 或 upstream-fact-doubt；started 与 completed 使用同一组值。

行为边界 / 关键规则

流程裁定

分析产物必须在 ## 流程裁定 中记录 本任务路径、判定依据、未满足的更高路径条件 和 升级触发条件 四个字段，每个字段恰好一次且非空。路径仅可为精简、标准或完整；文件数、模块数和推测性风险不能单独升级路径。analysis 的 finalize-local 会复用生命周期路径解析器校验该决定；缺失、重复或无效值必须直接修复正式产物后重跑。

持久化报告证据

生成分析报告时，先读取 .agents/rules/evidence-reporting.md。状态核对和成功检查记录命令、目标范围、状态/结构化结果、实际结果和未覆盖部分；失败、阻塞或争议才附决定性原文摘录。

• 涉及候选资格或 HD-N 判断时，先读取 .agents/rules/decision-qualification.md，基于 task.md 规范化约束/候选完成资格审计，并在分析产物记录三张资格审计决策表和资格快照；不得把来源不明或未确认约束自动升级为排除条件
• 本技能仅产出需求分析文档（analysis.md 或 analysis-r{N}.md）—— 不修改任何业务代码
• 严格基于 task.md 中已有的任务输入、需求、上下文和来源信息展开分析
• 生成会同步到 Issue 的任务或生命周期 Markdown 前，先读取 .agents/rules/sync-content-generation.md 并遵循其中的生成端约束；同步端不解析或改写正文
• 涉及旧行为、旧数据、旧 schema 或旧调用方时，先读取 .agents/rules/compatibility-policy.md；没有兼容准入证据时明确采用 current-only，不把推测写成需求
• 执行本技能后，你必须立即更新 task.md 中的任务状态

版本戳规则：创建或更新 task.md frontmatter 时，先读取 .agents/rules/version-stamp.md，并写入或刷新 agent_infra_version。

第 0 步：状态核对（执行前硬约束）

在加载 workflow / skill / rules 指令之后、做任何任务状态判断或用户可见结论之前，必须先执行状态核对。指令类文件读取不算对外动作或结论。

运行以下命令，并在本轮产物的 ## 状态核对 段记录任务/产物范围、关键结果和未覆盖部分；正常成功不粘贴完整目录清单或 task.md 尾部。失败、阻塞、身份不一致或争议时，附决定性原文行：

agent-infra-internal task-snapshot {task-id} --format text

状态核对完成前，禁止任何关于外部状态的断言（例如“代码没变”“测试已通过”“没有其他引用”），包括思考阶段。本门禁只提供结构下限；逐条证据配对和真实性仍需按报告模板与审查要求核对。

任务上下文解析

入口可省略 task ref；显式 task scope 仅接受 --task <ref> 或 -t <ref>，不再解释位置 task ref。保留其余业务操作数后调用 agent-infra-internal task-context resolve {task-scope}；{task-scope} 为空或 task flag 之一。只读取结构化结果的 taskId，后续把 {task-id} 绑定为完整 TASK-YYYYMMDD-HHMMSS。解析失败时透传非零退出码，不自行扫描任务。

解析任务引用，并确认任务位于本技能支持的状态或目录且存在 task.md；无法定位时按未找到任务处理并停止。

步骤开始：声明 started 事件

确认前置条件和轮次后、本轮第一个产出动作之前执行：

agent-infra-internal task-event {task-id} analyze.started --agent {standard-agent-token} --initiator {trigger-initiator} --request-id {request-id} --reason-code {reason-code}