# @antoneeo/agentic-sdlc-skill 中文文档 规范地址：https://npmcn.com/package/%40antoneeo/agentic-sdlc-skill/ 版本：1\.53\.1 npm 元数据更新时间：2026-11-05T05:22:29.816Z 中文译文更新时间：2026-11-06T07:58:33.277Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40antoneeo/agentic-sdlc-skill 原文对照：https://npmcn.com/package/%40antoneeo/agentic-sdlc-skill/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.1 MB，35 个文件 - TypeScript 类型：未声明 - 运行依赖：0 个 - 首次发布：2026-04-17T05:37:58.669Z - 最新版本发布：2026-11-05T05:22:29.605Z - 近 30 天下载量：4037（2026-10-06 至 2026-11-04，npm 官方下载统计） - 已发布版本数：69（近 12 个月 69 个） ## 中文简介 Document-First SDLC Protocol for Claude Code,双子座CLI,Google Antigravity and Codex 具有风险分解,远景治理,已安装支持文件以及可选的devPNT集成功能. ## 安装 ```sh npm install @antoneeo/agentic-sdlc-skill ``` 也可以使用：`pnpm add @antoneeo/agentic-sdlc-skill`、`yarn add @antoneeo/agentic-sdlc-skill`、`bun add @antoneeo/agentic-sdlc-skill` ## README # 代理SDLC Skill for Claude Code, 双子座 CLI, Google Antigravity & Codex 等 `agentic-sdlc` 是AI编码代理的文档-First SDLC协议。 它支持克洛德代码(Claude Code),Codex,双子座CLI,Google Antigravity 2.0,Cursor/Windsurf风格的项目指令,以及可选的devPNT治理. ## 1.53.1中有什么新鲜事 **在您已经信任它们后, 可再次安装代码钩 .** 安装器现在确认 Codex 保存的同意状态 `config.toml` 而不是把它当作错误的钩子配置。 现有的同意和克洛德配置得到保留. #### 怎么办 更新方式 `npm install -g @antoneeo/agentic-sdlc-skill@latest`,然后重新启动代码并检查设置 > 钩子(或 `/hooks` (《国家劳动力调查》)。 以前相信,未作修改的定义可能不需要获得另一批迅速同意。 安装不能带来信任. 完整历史 : [变化](https://github.com/Antoneeo/agentic-sdlc-skill/blob/main/CHANGELOG.md) ## 关键特性 - **风险相称的工作流程**: L1/L2/L3/Spike 三分法避免了轻活的重量级过程,具有对称性 **写入触发器** 表格将每个事件映射到它生成的文档(一个事件,一个目的地). - **愿景指导治理**: 使用独立项目 `ai_docs/vision/`; 混合项目使用devPNT `M-VISION` 作为里程碑 北星。 《愿景》将它命名为 **演员** ——"铸造"特性服务,各有一条光线——所以"UX"是为具体角色而设计的,而不是隐含的"用户". 每个愿景,包括M -VISION, 都只写在六个问题之后 **业主面谈** 而且你明确同意用你自己的话来说是一或两颗北星——这名特工从不单独写一个. - **架构通过——文件前的能力**:在L3中,在列出哪些变化之前,特征为: _能力_ 它需要并且每个都与平台相抗衡(EXISTS / INADEQUATE / MISSING); 所缺少的东西被设计成有其自身合同的组件,其中的特征是一位消费者——从未融入该特性的代码路径. A 类 `## Component Map` 内 `strategic/architecture.md` 是通行证读取的耐用目录,所以平台不是每个会话都从源得到的. 在代码库上 方法晚到 地图的沉默被视为 **未读, 不为空**它永远无法推翻一个 错过判决. - **执行纪律**:有明确的TDD(RED/GREEN/REFACTOR),首先用假说进行证据调试,按概率和核实成本排序,支持因果质询,并用回归检查来清理Poka-Yoke校正;L3光谱回转和单一代码审查定义被接入工作流程阶段. - **操作+理解指南+代理-全球KB**: 将用户提供的指向提炼成对来源有诚意的操作器 `GUIDE_*.md` (单位:千美元)`source_kind: document`),并让代理自动作者 **代码综合指南** (单位:千美元)`source_kind: code`) 对于复杂的组件——一个源性忠实的心智模型地图,它在整个会话中生存了下来,因此下个会话不会被重新定型并从部分理解中分解出组件. 工作前咨询;通过 `~/.agentic-sdlc`。 。 。 . - **几个人,一个项目**: 工作流程登记册(`audit/handoff.md`)为 **生成** 从每个开放的工作流一个文件开始,所以两个人在两个分支上打开或关闭两个工作流来编辑两个不同的文件,他们的合并是干净的. 单靠逐行工作流程是不够的——一个全球文件 `Date:` 标题击败了行级所有权——所以标题来源于出处,没有作者触及. 生成的视图仍然可能存在冲突;这种冲突通过重新运行来解决 `index`从来没有通过手,和 `validate` 在文件与其来源匹配之前拒绝 CLEAN 。 只获取附件审查日志 `merge=union` (内置驱动程序,无每克通配置). 所有这一切都没有VCS的功能:它是文件和一个生成器. - **合并审查简介和 E2E 脚本**: 每艘L3型关闭舰 `MERGE_REVIEW_[feature].md` 对于综合者——什么是审查,什么是通过哪个大门核实的,什么是只有人类才能判断的——用地图来自 `sdlc_check.py review-map` 每一个更改的文件类别 Review/DESIGN/EVENCE/GENERTED(生成的索引被跳过, `check` 证明他们),和 `E2E_TEST_[feature].md` 对于合并后的人类测试者:回归情景总是,行为改变时的新行为情景. - **逐字记录**: 每起L3 `audit/requests/REQUEST_[feature].md` 在"视觉之门"(Vision Gate)之前——业主自己的话和后来的每一项决定(回答,批准,费用,裁决),仅附加并被修改为机密——因此分析引用了所问的内容而不是用旁白来解释,审查者可以核实业主的陈述而不是信任作者. - **行动时的限制**:在L3处,使用箱、光谱物品和威胁携带ID,爆炸半径为1个 `### Preservation constraints` 表格(符号、调用者、必须真实的事物、证据). `sdlc_check.py constraints --unit ` 显示一个单位的制约 `--file ` 绑定文件 ; 在 Claude 代码上, 只有上下文的钩子在代理编辑 L3 会话中绑定文件之前就提醒它们 —— 它从未做出允许的决定 。 关闭时,保存行会移动到组件的代码指南. - **切入子代理执行**:一个经批准的设计项目变成一个经审定的可执行计划,一个管弦乐手可以通过子剂来驱动. - **自启动**: aSessionStart chinkits repo-sourced 取向; 确定性的自电电池守护技能本身的学说作为放电门. - **独立完成**: 与当地充分合作 `ai_docs/` 而不要求devPNT. - **devPNT 共生**:当devPNT可用时,"总体规划","行动计划","M-VISION",被管理文物成为权威的规划层,每个被管理文物在被提出前都会通过独立的代理审查;devPNT本身没有进行审查——这是你审查和批准的地方. - **独立审查,两次**:设计在执行前经过审查,在完成工作前由作者以外的人宣布完成,作者在固定的片段复制后获得整个审查授权,从不作解释。 三道独立跑道(新文本子接线器 > 一发即发) 宣布的自通道,只有在没有更高跑道可用时才合法:缺席,或许可加分并被拒绝——一个有门的跑道被问到,从未默默跳过,日志上写到哪个),上限为三发,每发审查一通日志行,一个PASS在"什么也找不到"上无效——它必须说明每个限制都满足了哪里. 设计审查通过后,所有者在写出任何代码前批准设计. - **问题纪律**:在将答案写入任何文件之前,一旦出现真正的怀疑,就会被问及——按分组,并按每种选择的利弊。 择取其能分明取胜而无所问取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 一个问题只有在特工先进行搜索,以结果命名搜索,并点出它解锁的决定——从不流出"我应该继续吗?"时才是合法的. - **已安装支持文件**: Claude, Codex, 双子座,和Google Antigravity 接收了完整的技能文件夹,包括: `templates.md`, (中文(简体) ), `architect.md`, (中文(简体) ), `guides.md`, (中文(简体) ), `vision.md`, (中文(简体) ), `tdd.md`, (中文(简体) ), `debugging.md`, (中文(简体) ), `elicitation.md`, (中文(简体) ), `review.md`, (中文(简体) ), `dispatch.md`, (中文(简体) ), `routing.md`, (中文(简体) ), `coordination.md`, (中文(简体) ), `hybrid.md`, (中文(简体) ), `ENFORCEMENT.md`, (中文(简体) ), `memory.md`,验证器的三个文件, `scripts/sdlc_check.py` + 键 `scripts/sdlc_core.py` + 键 `scripts/knowledge.py` 加上文件站点生成器 `scripts/docs_site.py` 及其页面 `docs_site/`,则 `LICENSE` 财务报告和审定财务报表 `NOTICE` 船在下面 船在下面. - **文档网站** (单位:千美元)`scripts/docs_site.py --root [--open] [--zip ]`:一个静态的,离线的,只读的关于代理在项目中读到的内容的网站——读取指南,远景,规则,文件,与下一步的每一个步骤一起公开工作,分析,以及拥有知识库,主题地图,每个事实及其确切的出处通道,以及出处文件. 写入 `.docs-site/` (加进 `.gitignore` 在第一次运行时, 外面 `ai_docs/`;无排名或建议. - **机械检查**:文件结构的可选验证器、生成的地物历史、陈旧的审计区和防护通道门—— `check`, (中文(简体) ), `validate`, (中文(简体) ), `index`, (中文(简体) ), `stale`, (中文(简体) ), `mark`, (中文(简体) ), `benefit`, (中文(简体) ), `gate`, (中文(简体) ), `plan`, (中文(简体) ), `orient`, (中文(简体) ), `migrate`, (中文(简体) ), `review-map` (代码镜片:为合并审查简报的更改文件分类), `commit-map` (代码镜头:检查一个同时进行若干场次工作的承诺的地图), `constraints` (代码镜头:单位的制约,或那些绑定文件). `benefit` 报告审查闸门已经捕捉到的东西,除了学说所花费的阅读费用外——它总是出0出而无定论,因为一个可以使建设失败的测量成为目标. ## 共享项目内存 所有四个镜头都包含默认的项目内存;安装需要的镜头, 不只是第二个技能 只是为了召回. `index` 登记册指南、决定和计划 在文档根的 `memory/INDEX.md`,链接原件而不复制. `recall "onboarding"` 找到跨域的相关元数据; 可选 `topics: [onboarding]` 按主题链接文档。 读原件为权威, 状况和证据:发现不是批准或执行证明. 登记时间: `index`结束文件记录,不是通过背景 观者. 现有项目获得下一个目录 `index`· ; `recall` 还看到活的元数据。 KB镜头仍然是摄取和 分类学. 营销保留其数字验证器。 看这技巧 `memory.md`。 。 。 . 供应商需要所有三个文件: 入口点, `sdlc_core.py`, (中文(简体) ), `knowledge.py`。 。 。 . ## 安装 ### 通过 npm ```bash npm install -g @antoneeo/agentic-sdlc-skill@latest ``` \- 够了 - 包裹 `postinstall` 运行安装器。 如果你的 npm 块 安装脚本( e)`--ignore-scripts`用手操作: ```bash agentic-sdlc-install-skill ``` > 命令只写在您的路径上 **全球** (单位:千美元)`-g`安装;在本地 `npm i`,作为 `npx agentic-sdlc-install-skill`。 。 。 . 安装者副本 `skills/agentic-sdlc-skill/` 循环进入本地技能地点: - 克劳德代码 : `~/.claude/skills/agentic-sdlc/` - 代码 : `~/.codex/skills/agentic-sdlc/` - 双子座CLI: `~/.gemini/skills/agentic-sdlc/` - 谷歌反重力: `~/.gemini/config/skills/agentic-sdlc/` (从双子座CLI中发现的;用 `ANTIGRAVITY_HOME`(中文(简体) ) 重新启动相关代理,或者在CLI支持的地方重新装入技能. 全球一揽子计划也揭露: ```bash agentic-sdlc-init ``` 在创建项目中运行 `ai_docs/`,Vision stubs等待您的采访,战略文件,审计计划和代理协议文件(`AGENTS.md` 还有反重力CLI表面, `CLAUDE.md`, (中文(简体) ), `GEMINI.md`, (中文(简体) ), `.cursorrules`) (中文(简体) ). 还有 **连接会话起始方向钩** 输入 `.claude/`,所以代理打开 将项目分解线、导线路由器、工作流程登记册和 在它做任何事情之前,应当先读取向导,而不要只在它记得要看的时候。 那个 接线曾经是手动步骤,记录在 `ENFORCEMENT.md`;作为手工,它是 跳过,一个项目可以完全由从未遇到过这一过程的代理人管理. 钩头命令名称为验证器, 因此当验证器居住时, 决定要收到哪些文件 它:一个回扣,卖主在共享中获得相对命令 `.claude/settings.json` (便携式-承诺);否则,路径是机器专用的并通向被忽略的 `.claude/settings.local.json`,每个队友运行 `init` 一次 一次吗 重运行 `init` 永远 重复钩子,其验证器不再解决的钩子报告为 **已损坏** 将校正改为已安装. ## 运行时形状 实际运行时间技能是文件夹 : ```text skills/agentic-sdlc-skill/ ├── SKILL.md ├── templates.md ├── architect.md ├── guides.md ├── vision.md ├── tdd.md ├── debugging.md ├── elicitation.md ├── review.md ├── dispatch.md ├── routing.md ├── coordination.md ├── hybrid.md ├── memory.md ├── ENFORCEMENT.md ├── LICENSE ├── NOTICE ├── docs_site/ │ ├── index.html │ ├── app.js │ ├── style.css │ └── strings.js └── scripts/ ├── sdlc_check.py ├── sdlc_core.py ├── knowledge.py └── docs_site.py ``` `SKILL.md` 是切入点。 辅助文件只有在代理需要时才会被加载或执行. 验证器是 **3个文件**数字 : `sdlc_check.py` 选择镜头, `sdlc_core.py` 拥有结构检查,以及 `knowledge.py` 添加共享内存和 KB 完整性 。 复制全部三件; 仅核心并不等同 . 安装或更新 npm 包, 将会话导向钩线 全机(用户级 Claude 代码设置和 Codex hooks.json;去除是站式选择退出) 没有更新覆盖 -- -- Enforcement.md 第4段. 也用同样的方法,每回的提醒, 引导核查和 强制召回(Forcement.md 第3段);召回费用约为每笔0.25 s 在 Claude 代码上编辑,并只在绑定文件中的 L3 上添加上下文. Codex在支持的本地补丁上添加了上下文;其耐久性在测试证据中被报告,而不是从克洛德推断出. 对于 Codex , 重新启动 a **当地** 并审查这四项定义 `/hooks`。 。 。 . 安装者配置了钩子; 它不给予信任, 启用已禁用的特性或 覆盖管理的政策 。 重复/更新保留现有定义的字节-相同 并尊重删除为选择退出。 地方指挥钩不在云管下运行. 使用清晰的软件包 `scripts/preuninstall.js` 如果勾结清理, 在删除前删除 需要: npm 版本可以跳过生命周期 uninstall callbacks 无法执行此清理 . ## 家族:四相相片,一相脊椎 同样的过程,四个忠诚的学科——代理人的断言必须忠实于: 1 | 软件包 | 忠诚 | 工作单位 | 自主理论 | | --- | --- | --- | --- | | [`@antoneeo/agentic-sdlc-skill`](https://www.npmjs.com/package/@antoneeo/agentic-sdlc-skill) | 此寄存器的代码 | 特性 | `architect.md`, (中文(简体) ), `tdd.md`, (中文(简体) ), `debugging.md` | | [`@antoneeo/kb-agentic-skill`](https://www.npmjs.com/package/@antoneeo/kb-agentic-skill) | 您提供的文档 | 专题 | `taxonomy.md`, (中文(简体) ), `distillation.md`, (中文(简体) ), `reconciliation.md` | | [`@antoneeo/mkt-agentic-sdlc-skill`](https://www.npmjs.com/package/@antoneeo/mkt-agentic-sdlc-skill) | 市场证据 | 参与 | `frameworks.md`, (中文(简体) ), `research.md` | | [`@antoneeo/course-creator`](https://npmcn.com/package/%40antoneeo/agentic-sdlc-skill/distributions/course-creator/README.md) | 学习者的起点和核实的教学来源 | 课程 | `learning_design.md`, (中文(简体) ), `source_check.md`, (中文(简体) ), `simulation.md`, (中文(简体) ), `feedback.md` | 四个镜头共用了过程脊椎和知识集成引擎. 只安装一个您需要的; 当两个生活在同一个工程中时, `routing.md` 决定哪个镜头拥有一个特定的作品. 营销进行数字检查;课程创建者检查教学结构。 结构检查既不证明事实真相,也不证明人类的学习. ## 独立对混合 独立 : - `ai_docs/` 是真理的来源. - 远景、分析、审计、交接、测试策略和特色历史在当地得到保持. 混合/ DevPNT : - devPNT 规范 `M-VISION`,"总体规划","行动计划",以及版本文物. - `ai_docs/` 作为可读上下文、倒置、交接或阴影副本,仍然有用. - 用户请求、本地视野和devPNT之间的差异 `M-VISION` 在执行之前必须浮出水面. ## 双子体扩展选项 您仍可将此文件夹安装为双子文件夹扩展名 : ```bash gemini extensions install . ``` 对于本地双子星代理技能, npm 安装器现在将技能文件夹复制到 `~/.gemini/skills/agentic-sdlc/`。 。 。 . ## 创建者 创建于 **安东尼奥·平托** (单位:千美元)[GitHub 图像](https://github.com/Antoneeo)) (中文(简体) ). ## 许可证 Apache-2.0——整个术语在 `LICENSE` 文件,属性在 `NOTICE`. 版权2026 Antonio Pinto. 如果您重新分配此技能, 或是修改过的版本, 请保留 `LICENSE` 财务报告和审定财务报表 `NOTICE` 带着它. 使用您自己项目中的技能不承担任何义务:它创建的文档或模板都是您的,验证器的副本及其测试也放在该项目中,以检查自己的文档. 以麻省理工学院的许可证发放了最多1.33.0的版本,并在许可证下继续提供. 如果您在商业工作中使用该技能,请在您的产品页面或网站上注明。 这是请求,不是许可证的条件。 现成的徽章: ```markdown [![Made with agentic-sdlc](https://img.shields.io/badge/made%20with-agentic--sdlc-blue)](https://www.npmjs.com/package/@antoneeo/agentic-sdlc-skill) ``` ## 哪个模式运行它 技能名称 **能力级别**,从不提供 —— 学说中的一个模型名称 腐烂在下一次发布。 约束是你的,规则是一行: > **届会的会场是其发挥自己作用的最高层.** 授权管理文物——视觉,分析,使用案例 威胁模式 **深层** 角色:其产出为判断,无 下游得分 所以,一个会 DESIGN想要你最强的模型. 仅执行已经批准的计划或进行小规模维护的会话, 可以坐低一层。 最便宜的级别是主会话的错选择 不管任务是什么,因为失败没有错误的答案——它是 **默默不应用进程**: 从不运行, 路由器判决 宣布没有检查, 一个门没有人注意到。 失败是看不见的 这里每张支票. **审阅员的等级不是自动的.** 对一些客户来说是副代理 继承会话模式;在其它模式上,它从自己的定义中取出一个,所以 强会可以由弱会审查,弱会可以购买 强烈评论。 故意设定 `model` 栏中选择的位置. **避免一个组合**: 撰写于下层并审阅于下层 在同一单位。 一个披露的弱点是披露的弱点;两个是 没人能读懂 你的客户没有更好的选择 仍在审查中,记录了两个事实——一个披露的最坏案例 跳过审查. ## 常见问题 ### @antoneeo/agentic-sdlc-skill 是什么？ Document-First SDLC Protocol for Claude Code,双子座CLI,Google Antigravity and Codex 具有风险分解,远景治理,已安装支持文件以及可选的devPNT集成功能\. ### 如何安装 @antoneeo/agentic-sdlc-skill？ 在项目目录运行 npm install @antoneeo/agentic-sdlc-skill，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agentic-sdlc-init、agentic-sdlc-install-skill，可以用 npx agentic-sdlc-init 直接运行。 ### @antoneeo/agentic-sdlc-skill 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/antoneeo\_\_agentic-sdlc-skill 是否存在。 ### @antoneeo/agentic-sdlc-skill 可以商用吗？ @antoneeo/agentic-sdlc-skill 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @antoneeo/agentic-sdlc-skill 的下载量有多少？ 根据 npm 官方下载统计，@antoneeo/agentic-sdlc-skill 在 2026/10/06 – 2026/11/04 这 30 天内被下载 4,037 次，日均约 135 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @antoneeo/agentic-sdlc-skill 还在维护吗？ 最新版本 1\.53\.1 发布于 2026/11/05（1 天前）；至今共发布 69 个版本，其中过去 12 个月发布了 69 个；首次发布于 2026/04/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。