SuperAPI AI 工具集

agent-ledger-and-delivery

智能体与模型

查看项目

更新于 10-16 06:16

技能介绍

用途:定义 agent 工作如何被记录,使评审者能看到提示、意图、变更、验证、风险以及关联的任务或提交。该技能聚焦交付证据与长期可追溯性,不负责提交拆分或任务状态归属;ledger 可引用任务和提交,但任务当前状态与验收标准仍由 tasks.md、issue tracker 或其他工作状态界面负责。

适用场景:用户要求创建、重构或评估 agent_chats、agents_chat、评审描述、交付记录、关联任务或关联提交;项目要求每次交付都有 AI 协作记录;验证、风险、后续步骤与产物引用需要稳定格式。

所需输入:现有 ledger 目录与命名规则;用户目标、变更摘要、验证命令、产物、任务 ID、评审或提交;仓库是否要求 ledger 更新与代码在同一提交中。

执行顺序:先阅读现有 ledger 规则与近期示例;再设计记录 schema、命名、必填章节及任务/提交/评审耦合;最后输出可复用 ledger 模板与交付检查清单。

步骤:搜索 agent_chats、agents_chat、CI 检查、AGENTS 规则与评审模板;确认记录粒度(按提交、评审、会话或里程碑);若无 ledger 约定,按 references/build-when-missing.md 建立最小目录与模板;定义文件名、frontmatter、正文章节、语言与脱敏规则;定义何时必须更新 ledger、何时允许跳过及如何记录跳过;定义评审或交付摘要如何引用任务、提交、验证、产物、风险与后续步骤。保持 ledger 与原子提交规则分离(原子提交由 atomic-commit-discipline 定义),保持 ledger 与任务状态规则分离。

检查项:完整性(提示、目标、变更、验证、风险、关联任务或提交);耦合性(代码变更对应 ledger 或明确跳过原因);边界(ledger 摘要不替代任务状态或验收标准更新);可读性(未来 agent 能据此恢复);隐私(不含令牌、密钥、私密聊天记录或敏感日志);避免两套 ledger 格式漂移。

输出格式:Detected Mapping、Ledger Policy、Delivery Summary Template、Task/Commit/Review Coupling、Validation Evidence、Skip Policy。常见错误包括写成日记而非验证与风险证据、评审摘要与实际验证不一致、用 ledger 条目替代更新任务状态、混入原子提交规则、记录敏感内容。