AoA技术库：面向编码智能体与开发者的可复用工程实践规范

aoa-techniques是一个开源的工程实践规范库，为编码智能体和人类开发者提供可复用、可验证、可编排的原子级技术单元，涵盖验证模式、安全协议、文档结构和评估循环等核心领域。该项目并非简单的代码片段集合，而是经过精心设计的公共工程实践规范库，具有双重属性：作为独立公共库供开发者集成单个技术单元，以及作为AoA内部器官保持稳定的ID和拓扑结构。

aoa-techniques（Agents of Abyss技术库）是独特的开源项目，核心定位是为编码智能体和人类开发者提供可复用、可验证、可编排的原子级技术单元。核心理念：一个技术单元应是原子的、可执行的、可复现的工程实践，能被分类、模板化、验证，并在正确上下文下交付给小型智能体使用。其双重属性：1. 独立公共库：开发者可提取单个技术单元集成到智能体系统，无需部署整个OS Abyss生态；2. AoA内部器官：在OS Abyss内部保持稳定ID、拓扑结构、来源、审查机制，生成兄弟仓库可消费的界面。

aoa-techniques对技术单元有严格定义，区别于随意代码片段或项目专属hack。优秀技术单元需包含：清晰的意图和使用边界、原子级可执行动作、跨domain/kind/未来轴的拓扑适配、显式输入输出和风险、验证方法、可移植性适配说明、足够结构支持推广审查复用。不适合收录的内容：随机代码片段、无适配说明的私有项目hack、含敏感信息的配置、原始日志、仅适用于特定项目的dump、未文档化的脚本、更适合作为技能/评估/路由逻辑/角色契约/剧本的对象。

aoa-techniques采用精心设计的目录结构确保可发现性和可维护性。核心目录包括：techniques/（发布的技术单元bundle）、templates/（创作脚手架）、generated/（派生目录、胶囊等）、legacy/（历史版本和迁移记录）、mechanics/（跨机制运动界面）、docs/（方向、审查准则等）、scripts/和tests/（辅助工具）。技术单元状态：promoted（已推广）、canonical（规范级）、deprecated（已弃用）。早期孵化在其他地方，根目录指向精选公共规范。

aoa-techniques涵盖编码智能体工程的关键领域：1.智能体工作流（计划-执行-验证循环、多智能体协作协议等）；2.验证模式（代码正确性验证、输出格式校验等）；3.文档结构（README模板、API文档规范等）；4.评估与监控循环（性能指标、质量评估框架等）；5.安全与卫生协议（输入验证、敏感信息处理等）；6.基础设施操作技术（配置管理、服务发现等）；7.跨仓库推广和复用模式（依赖管理、接口适配等）。

aoa-techniques采用独特贡献模型：技术所有权与执行责任分离——aoa-techniques拥有实践含义（定义技术应做什么、如何验证分类），兄弟仓库拥有执行、证明等。技术从候选到发布流程：pick→inspect→expand→object use。迁移机制：当原子级可复用契约能从兄弟仓库清晰提取，且满足公共安全、明确边界、可移植时，可进入aoa-techniques。

aoa-techniques探索如何将人类工程智慧系统化、规范化，使其可被智能体理解执行。对智能体开发者：提供可复用最佳实践、验证过的模式、标准化接口；对人类开发者：知识沉淀、协作基础、质量保障；对行业：为AI编码智能体的行为可预测、可验证、可审计提供工程化解决思路——构建可复用技术基础设施、分解智能为可验证原子单元、建立人机协作清晰边界。

项目提供多条快速路径：按需求类型（仓库所有权、技术地图等）、按技术属性（原子性契约、功能阅读器等）、按审查和推广状态（状态界面、推广准备度等）、端到端示例（WALKTHROUGH.md）、边界执行和证明邻居（aoa-skills、aoa-evals等）。具体可参考CHARTER.md、TECHNIQUE_INDEX.md、docs/VIA_NEGATIVA_CHECKLIST.md等文档。