artifact-tracking

Artifact Tracking 技能为通过 Token 高效能文件管理软件开发工作流程提供了强大的架构。此技能专为 Claude 等 AI 代理设计，以 YAML 与 Markdown 混合格式取代冗长的纯 Markdown 追踪记录。通过利用机器可读的 Frontmatter，系统使代理程序能够进行精确的字段层级更新与查询，与传统的全文件解析相比，Token 使用量可降低 95-99%。对于旨在维护复杂、多阶段项目结构而又不会触及上下文限制或产生不必要成本的工程团队与自主代理程序而言，这是一项必备工具。

• 通过标准化指令接口启用 CREATE、UPDATE、QUERY、VALIDATE 与 ORCHESTRATE 操作。

• 具备结构化元数据，用于自动化的任务状态更新、依赖性管理与进度报告。

• 支持基于阶段的项目文件，包含进度追踪器、技术背景说明以及与 PRD 对齐的实现计划。

• 通过允许代理程序仅读取必要的机器可读 YAML 状态而非整个项目日志，简化了工作阶段移交的流程。

• 与专属代理程序（tracker, query, validator）整合，确保在整个开发生命周期中符合结构规范并产出高质量成果。

• 适用于处理长期功能开发或复杂重构任务的软件工程师、项目负责人以及 AI 编排人员。

• 输入要求：必须遵循特定的文件路径模式，例如 .claude/progress/[prd-name]/phase-N-progress.md。

• 最佳实践：每个阶段维护一个进度文件，并使用嵌入式的 Task() 函数语法来执行一致的状态变更。

• 限制：必须严格遵守文件政策规范；必须使用提供的工具验证结构描述（Schema），以确保符合编排需求。

• 请始终调用合适的代理程序（例如用于更新的 artifact-tracker，或用于检索的 artifact-query）以最大化效能并维护记录档的完整性。