astack：为AI编程智能体设计的标准化工作流技能框架

本文介绍astack项目，一个为AI编程智能体设计的轻量级工作流技能框架。它提供九个标准化的工作流技能，从头脑风暴到代码审查，并配套文档结构检查器，确保AI生成的文档不会随时间漂移。

随着Claude Code、Codex等AI编程智能体的普及，开发者面临一个新问题：如何让多个智能体在协作时保持一致的工作方式和文档标准？astack项目应运而生，它提供了一套共享的"词汇表"，让不同智能体能够理解并执行标准化的工作流程。

astack将常见开发活动抽象为九个可复用的工作流技能：

技能名称	角色描述
astack	元技能——评估任务规模（小/中/大）并路由到合适的工作流
astack-brainstorm	编码前的思考与问题分析
astack-plan	将需求转化为可执行的实现计划
astack-work	在需求明确后执行实现或调试
astack-review	对代码、文档或计划进行只读审查
astack-qa	测试流程、复现bug、按评分标准评估质量
astack-ship	提交、推送、创建PR、部署
astack-cleanup	非文档类的结构修复（技能、运行时配置、入口点）
astack-compound	从有意义的工作中提炼持久知识
astack-docs	初始化/迁移/检查文档树——OpenAI风格布局

这种设计让智能体能够"说同一种语言"，无论底层使用哪个模型或工具。

astack最具特色的设计是其文档结构检查器。它认识到一个现实问题：当AI负责大部分文档编写时，文档结构容易随时间漂移。检查器通过强制性的文档布局规范来解决这个问题。

当仓库选择加入（在根目录创建.astack/）时，检查器强制执行以下结构：

AGENTS.md（≤150行，需目录）
ARCHITECTURE.md（顶层系统架构图）
docs/
├── DESIGN.md, FRONTEND.md, PLANS.md, PRODUCT_SENSE.md
├── QUALITY_SCORE.md, RELIABILITY.md, SECURITY.md
├── design-docs/（决策文档，需YAML前置元数据）
│   └── index.md
├── exec-plans/
│   ├── active/（进行中计划）
│   ├── completed/
│   └── tech-debt-tracker.md
├── generated/（自动生成产物）
├── product-specs/
├── references/（外部文档，*-llms.txt格式）
└── _legacy/（迁移期间的临时隔离区）

每个设计文档、执行计划和产品规格都必须包含YAML前置元数据：

---
status: stable  # draft, active, completed, archived
updated: 2026-04-21
folders: [mobile]  # 适用的子项目，或 [all]
---

这种强制规范确保文档的一致性和可追踪性。

npx skills add andthezhang/astack

这会将所有astack-*技能安装到智能体技能目录，并在skills-lock.json中记录版本。