mirror of
https://github.com/microsoft/BCQuality.git
synced 2026-08-06 17:36:53 +01:00
Re-scope author super-skill to feature level (al-feature-author)
Turn the object-granularity al-object-author super-skill into the feature/PR-level al-feature-author - the true authoring counterpart of al-code-review, which takes a whole PR. feature-spec in -> whole-PR code-artifact out. - microsoft/skills/author/al-feature-author.md (renamed from al-object-author.md): takes inputs [feature-spec]; decomposes it into a cross-referenced object graph, allocates a contiguous object-ID block, applies the mandatory affix, resolves cross-object references (API page SourceTable = authored master), fans each derived object-spec out to the worklisted leaves, rolls up their artifacts, reconciles the refs, and enumerates the objects no current leaf authors (List/Card pages, permission set, install codeunit) as open-questions. Worked example: a Membership feature -> 3 artifacts (master table + setup table from al-table-author, API page from al-api-page-author) rolling up to completed. - skills/do.md (composition v1.1, STABLE-CONTRACT): add feature-spec to the standard inputs; extend Relevance so a super-skill's inputs need not equal its leaves' - it may derive the leaves' inputs by decomposing its own; generalize Action rollup to findings-report OR code-artifact. Review (findings) semantics read identically - behavior-preserving. - .github/scripts/validate_frontmatter.py: add feature-spec to STANDARD_INPUTS. #67 R26 generalization unchanged. - README.md, agent-consumption.md: author family's top-level skill is now al-feature-author. The al-table-author leaf and the R26 generalization from #67 are unchanged. Knowledge article count unchanged at 199. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
parent
afd33883c0
commit
2401443ef8
6 changed files with 424 additions and 314 deletions
|
|
@ -71,7 +71,7 @@ The output contract is defined in the DO meta-skill so that every action skill
|
|||
|
||||
The orchestrator parses this **without skill-specific logic**. This is the point of the contract: orchestrators and action skills evolve independently.
|
||||
|
||||
> **Authoring skills.** The same four-step pattern also drives *authoring* skills, which generate code rather than review it. They consume an `object-spec` and emit a `code-artifact` (the full generated AL as an escaped string, with per-artifact `references`, `notes`, and task-level `open-questions`) instead of a findings-report. The orchestrator maps each artifact to **file creation or scaffolding** in the target repo rather than to PR comments or build gates. The first example is `microsoft/skills/author/al-api-page-author.md`; the `code-artifact` contract is defined in [`skills/do.md`](skills/do.md). A second leaf, `microsoft/skills/author/al-table-author.md`, generates a master table and its setup table, and both author leaves compose under the `microsoft/skills/author/al-object-author.md` super-skill — the authoring counterpart to how `al-code-review` composes the review leaves.
|
||||
> **Authoring skills.** The same four-step pattern also drives *authoring* skills, which generate code rather than review it. They consume an `object-spec` and emit a `code-artifact` (the full generated AL as an escaped string, with per-artifact `references`, `notes`, and task-level `open-questions`) instead of a findings-report. The orchestrator maps each artifact to **file creation or scaffolding** in the target repo rather than to PR comments or build gates. The object-type leaves are `microsoft/skills/author/al-api-page-author.md` (API page) and `microsoft/skills/author/al-table-author.md` (master table and its setup table); the `code-artifact` contract is defined in [`skills/do.md`](skills/do.md). The authoring family's top-level skill is the `microsoft/skills/author/al-feature-author.md` super-skill: it takes a `feature-spec`, decomposes it into per-object specs, composes the object-type author leaves, reconciles cross-object references, and emits a whole-PR `code-artifact` — the authoring counterpart to how `al-code-review` takes a PR and composes the review leaves.
|
||||
|
||||
### 7. Orchestrator integrates
|
||||
The orchestrator turns findings into PR comments, build gates, or IDE diagnostics, and links the references back to the knowledge files so the PR author — human or agent — can read the guidance.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue